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Chapter 52 Window Manager Update 



This chapter documents new features of the Window Manager. The 
complete reference to the Window Manager is in Volume 2, Chapter 25 of 
the y^ple IIGS Toolbox Reference. 



52-1 



Af^le UGS Toolbox Reference. Volume 3 



Beta Draft 



30 August 1989 



Error corrections 

This section corrects some errors in the Window Manager documentation in the Apple IIGS 
Toolbox Reference. 

■ The manual's description of SetzoomRect is incorrect. The correct description is as 
follows: 

Sets the f zoomed bit of the window's wFrame record to 0. The rectangle passed to 
SetzoomRect then becomes the window's zoom rectangle. The window's size and 
position when SetzoomRect is called becomes the window's unzoomed size and 
position, regardless of what the unzoomed characteristics were before SetzoomRect 
was called. 

■ Apple IIGS Toolbox Reference page 25-126, third line: 

If wmTaskMask bit tminf o (bit 15) " 1 

should read: 

If wmTaskMask bit tmInf o (bit 15) " 

■ When used with a window that does not have scroll bars, the call windNewRes calls the 
window's defProc to recompute window regions. A call to sizewindow is not 
necessary under these circumstances. 
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New features in the Window Manager 

This section explains new features of the Window Manager, and clarifies points that were 
not made explicit before. 

■ TaskMaster now brings application windows to the front after dragging is complete. 
TaskMaster previously brought windows to the front before dragging. 

■ Using the SetOriginMask call, a programmer can control the horizontal scrolling 
characteristics of windows that TaskMaster scrolls. A common use of 
SetOriginMask is to ensure that the window origin is aligned on an even pixel, so 
that colors do not change if the display mode is changed between 320 and 640. When 
using the call, be sure that the horizontal scroll value is a whole multiple of the mask 
value. Otherwise, strange behavior can occur. As an extreme example, consider an 
origin value of 32 and a scroll amount of 1. Using the right scroll arrow will not scroll the 
window at all, and using the left one will scroll it by a value of 32. The new control value 
for the scrolling is calculated by adding or subtracting the scroll value and the current 
value and applying the mask. In this case adding 1 and masking results in the original 
value. Subtracting 1 and masking results in a new value that is 32 less than the old value. 

■ Standard windows can now draw their titles in 16 colors regardless of mode. 

■ The grid parameter of the call Dragwindow has been renamed dragFlag. Bits 
through 7 specify the gridvzlue. Bits 8 through 14 are reserved bits; they must be set to 
0. Bit 15 is a selection flag; if its value is 1, then the window will be brought to the top 
after dragging. 

■ It is no longer possible to specify grid values of 256 or 512. 

■ The Window Manager now uses the same defauk desktop drawing scheme as the . 
Finder. When the Window Manager starts up, it looks for a DeskMessage in the 
message center. This DeskMessage is formatted as follows: 



$00 














Reserved 




Long— Used by message center 


$04 




messType 




Word— Message type: must be set to $0002 


$06 




drawType 




Word— Indicates content of drawData 


$08 














drawData 




Array— Data for desktop; type specified in drawType 

• 
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Indicates the type of data stored at drawData: 

drawData contains pattern information 
drawData contains picture information 

Contains the pattern or picture data for the desktop image. If 
drawType is set to 0, then drawData contains 32 bytes of 
pattern data. The pattern defines 64 pixels arranged in an 8-by-8 
array. In 320 mode 4 bits are needed for each pixel; in 640 mode, 
the system requires 2 bits per pixel. The system uses this pattem 
to seed the desktop image. 

If drawType is setto 1, then drawData contains 32,000 bytes 
of picture data; the system copies this data directiy to screen 
memory. See Chapter 16, "QuickDraw II," in the Toolbox 
Reference for details on pattem or picture images. 

By loading a DeskMessage into the message center, your program can set a custom 
desktop image. 

■ Window Manager now supports a new entry point, TaskMasterDA, that allows desk 
accessories to use TaskMaster. Previously, desk accessories could not rely on 
TaskMaster, because they had to work with applications that do not use TaskMaster. 
Desk accessories obtain the data for their task record from the Desk Manager. 
TaskMaster processes task records for desk accessories in the same way that it 
processes application task records. 

■ The SizeWindow and ResizeWindow tOOl calls now invoke the NotifyCtls 
Control Manager tool call whenever the user changes the window size. This allows 
applications to show a control in a constant position with respect to the lower or right 
border of a window. For example, now the growcontroi control definition 
procedure can automatically move controls in response to a user dragging the size box. 



drawType 


1 

drawData 
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Alert windows 



The new Alert window call (described in "New Window Manager calls," later in this 
chapter) can be used to create alert windows for presenting the user with important 
messages. An alert window is similar to a modal dialog box. It requires that the user click a 
button in the window before doing anything else, and so provides a useful way to 
communicate vital messages such as warnings or error reports. The call does all the work of 
creating and displaying the window and contents for the alert, and returns the ID of the 
button that the user chooses. 

Aiertwindow accepts a reference to a string that contains its message, and a reference 
to an array of substitution strings. The substitution strings can be any of seven standard 
strings (such as "OK," "Continue," and so on) or can be specified by the application and 
stored in the buffer to which the substitution-string pointer refers. The format of the 
Aiertwindow input String is 



$00 f 
$xx 



$xx 
$xx 



$xx 
$xx 



$xx 



size 



ioonSpec 



separator 



Sep 



buttonstrings 



terminator 



Block 



: Block 
Byte 



messageText • Character array 
Byte 



Charader array 
Byte 
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size A variable-length block that specifies the size of the alert window to 

be displayed. Valid ASCII values for the first byte lie in the range from 
through 9 and have the following meanings: 



Custom size and position, specified by rectangle 
definition (as shown below) 

1 30-character display window 

2 60-character display window 

3 110-character display window 

4 175-character display window 

5 110-character display window 

6 150-character display window 

7 200-character display window 

8 250-character display window 

9 300-character display window 



If the value of the first byte of size is not O, then the block consists 
only of that byte. If size is set to 0, then you must specify the custom 
rectangle immediately after the size field: 





vl 




Word— y cooridnate of upper-left comer 




hi 




Word— X cooridnate of upper-left comer 




v2 




Word— y cooridnate of lower-right comer 




h2 




Wad— X coaidnate of lower-right comer 



Since Aiertwindow provides a limited number of standard sizes, it 
is possible to create alerts that display properly whether the Apple 
IIGS is in 320 or 640 mode. It is necessary, however, to design the text 
and buttons carefully in order to make this work. 

Table 52-1 shows the dimensions of the standard alert windows. This 
table gives only an approximate idea of the size of each window. 
Application code should not rely on the exact widths, heights, or 
position of standard windows. 
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■ Table 52-1 Standard alert window sizes 



size value 


Height 320 


Width 320 


Height 640 


width 640 


1 


46 


152 


46 


200 


2 


62 


176 


54 


228 


3 


62 


252 


62 


300 


4 


90 


252 


72 


352 


5 


54 


252 


46 


400 


6 


62 


300 


54 


452 


7 


80 


300 


62 


500 


8 


108 


300 


72 


552 


9 


134 


300 


80 


600 



iconSpec A variable-length block that specifies the type of icon to be displayed 

in the alert window. Valid ASCII values for the first byte lie in the range 
from through 9 and have the following meanings: 






No icon 


1 


Custom icon; followed by an icon specification, as 




shown below 


2 


Stop icon 


3 


Note icon 


4 


Caution icon 


5 


Disk icon 


6 


Disk swap icon 


7-9 


Reserved 



If the first byte of iconSpec has a value other than i, then the field 
consists only of that byte. If the first byte is set to i, then it must be 
followed by an icon specification: 











— ImagePtr 




LcMig— Pointer to image data 


— ImageWidth — 


Word- 


-Width, in bytes, of tlie image data 


— imageHelght 




Word- 


-Height in scan lines, of the image data 
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separator Specifies a character that will divide sub-strings in the remainder of 

the Aiertwindow input String, The separator ik.\d can contain any 
character, but the character cannot appear in the message text or 
button strings. The separator character divides the message from the 
first button string and the button strings from each other. For 
purposes of standardization, the slash (/) character is recommended, 
unless you will be substituting pathnames. 

Do not include a separator character in any substitution strings. The 
Window Manager performs substitutions before scanning the alert 
string for separators. For example, if the separator character is a slash 
and a pathname containing several slashes is substituted for the string, 
the resulting alert window will contain several more buttons than you 
intended. 

messageText Specifies the message to be displayed in the alert window. Any 

characters allowed by le Text box 2 are allowed in the message text. 
See "Special Characters" later in this chapter for additional 
characteristics of Aiertwindow message text. The total size of 
message text, after substitution of strings, is limited to 1000 
characters. 

5^ A 5^«ra/or character. 

buttonStrings Specifies titles for up to three buttons to be displayed in the alert 
window. If there is more than one title, then the titles must be 
separated from one another by a separator character. These buttons 
will be evenly spaced and centered at the bottom of the alert window. 
The width of each button is the same and is set by the widest button 
title. The maximum length of button text after substitution of strings 
is 80 characters. 

terminator Marks the end of the alert string. Must be set to ($00). 
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Special characters 

The following special characters can be embedded in the message text and button 
strings of an Aiertwindow input string. If a special character is to appear in the text of a 
button or message, you must enter it twice in the string. For example, if you want to 
appear in an alert message, you must enter it in the message string as 

A caret {'-) designates the default button. The default button is the 
button selected if the user presses the Return key on the keyboard. This 
button will also appear outlined in bold on the screen. Only one button 
can be the default button. After the caret, the button title must follow, 
as for any other button. Other special characters may also appear after 
the caret. A single caret in the body of message text has no effect and is 
deleted from the message. 

# Substitute standard string. The number sign (#) must be followed by a 

decimal number. Numbers through 6 can be used. Numbers 7 through 9 
are reserved and should not be used. The standard substitution strings are 



#0 OK 

#1 Cancel 

#2 Yes 

#3 No 

#4 Try Again 

#5 Quit 

#6 Continue 



* Substitute given string. The asterisk (*) character followed by an ASCII 

decimal number from '0' through '9' denotes a substitution string to be 
inserted at that point. The asterisk and the following number will be 
replaced by the corresponding string in the specified substitution array. 
A pointer to the substitution array is passed as a parameter to the 
Aiertwindow call. The Substitution array is defined as an array of 
pointers. Table 52-2 shows the format of a substitution string array. 
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■ Table 52-2 



Substitution string array 



LONG[0] 
L0NG[1] 
L0NG[2] 
LONGB] 
L0NG[4] 
L0NG[5] 
L0NGI6] 
L0NGI7] 
L0NGI8] 
L0NG[9] 



Pointer to 
Pointer to 
Pointer to 
Pointer to 
Pointer to 
Pointer to 
Pointer to 
Pointer to 
Pointer to 
Pointer to 



string 
string 
string 
string 
string 
string 
string 
string 
string 
string 



that will 
that will 
that will 
that will 
that will 
that will 
that will 
that will 
that will 
that will 



substitute for * o 
substitute for * i 
substitute for *2 
substitute for * 3 
substitute for * 4 
substitute for * 5 
substitute for * 6 
substitute for * 7 
substitute for * 8 
substitute for * 9 



Substitution strings can be C strings or Pascal strings, or may be terminated by a carriage 
return. A parameter to the Aiertwindow tool call allows you to specify the type of 
strings in the substitution array. 

Alert window example 

Following are some examples of alert strings that can be passed to Aiertwindow in 
65816 Assembly language syntax. 

A simple alert string: 
dc c 'is/Text of Message/Button l',il'0' 



Size 50 high\ 
by 200 wide. 




Message 



Button title. 



Zero terminates alert. 



TeKt of Message 



Button 1 
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A more complex alert string; 

dc c'51/This is the *0 of *3 alert *2*1 and standard' 

dc c'text called "#4" /• 

dc c"^#0,Really/*4/Yo! ^il'O' 



This is the message teKt of an alert lulndoui and standard 
tent called "Try Again." 



OK, Really 



Door #2 



Vol 



where the substitution array ■= 





dc 


14 ' subO, subl, sub2, sub3, sub4 


subO 


dc 


c 'message text ',11' 0' 


subl 


dc 


c ' dow • , 11 ' ' 


sub2 


dc 


c'win',il'13' 


sub3 


dc 


c'an',il'0' 


sub4 


dc 


c'Door #2',11'0' 
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TaskMaster result codes 

Table 52-3 lists all the possible TaskMaster result codes. 



■ Table 52-3 TaskMaster result codes 



Name 


Value 


Description 


Null 


$0000 


Successful 


mouseDownEvt 


$0001 


Event Code - 


mouseUpEvt 


$0002 


Event Code - 


keyDownEvt 


$0003 


Event Code - 


autoKeyEvt 


$0005 


Event Code - 


updateEvt 


$0006 


Event Code - 


activateEvt 


$0008 


Event Code - 


switchEvt 


$0009 


Event Code - 


deskAccEvt 


&• AAA A 

$000A 


Event Code - 


drive rEvt 


$000B 


Event Code - 


applEvt 


$000L 


event Looe - 


app2Evt 


$ooou 


tvent Loae - 


app3Evt 


$000b 


Event Code - 


app4Evt 


$000F 


Event Code - 


wNoHit 


$0000 


Alias for no event 


inNull 


$0000 


Alias for no event 


inKey 


$0003 


Alias for keystroke 


inButtDwn 


$0001 


Alias for button down 


inUpdate 


$0006 


Alias for update event 


wInDesk 


$0010 


On Desktop 


wInMenuBar 


$0011 


On System Menu Bar 


wClickCalled 


$0012 


Systemciick called (returned only as action) 


wInContent 


$0013 


In content region 


wInDrag 


$0014 


In drag region 


wInGrow 


$0015 


In grow region, active window only 


wlnGoAway 


$0016 


In go-away region, active window only 
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wInZoom 




In zoom region, active window only 


wininf o 


$0018 


In iniormation bar 


wInSpecial 


$ooiy 


Item ID selected was 250-255 


wInDeskltem 


$001A 


Item ID selected was 1-249 


wInFrame 


$001B 


In frame, but not on anything else 


wInactMenu 


$001C 


Inactive menu item selected 


wClosedNDA 


$001D 


Desk accessory closed (returned only as action) 


wCalledSysEdit 


$001 E 


SystemEdit called (returned only as action) 


wTrackZoom 


$001F 


Zoom box clicked, but not selected (action only) 


wHitFrame 


$0020 


Button down on frame, made active (action only) 


wInControl 


$0021 


Button or keystroke in control (can be returned as 






event code and as action) 


wInControlMenu 


$0022 


Control handled menu item 


wInSysWindow 


$8000 


High bit set for system windows 
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Window Manager data structures 

This section discusses tlie format and content of ciianged Window Manager data 
structures. 

Window record 

The window record data structure has been redefined. The new definition is illustrated in 
Figure 52-1. 
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■ Figure 52-1 Window record definition 



$00 














wNext 


— 


Long — Pointer to next window; NIL at end of list 


$04 


















Array— Window's grafPoit (170 bytes) 


$AE 














wDefProc 


- 


Long— Pointer to control definition procedure 


$B2 














wRefCon 




Long— Reserved for application use 


$B6 














wContDraw 




Long-Pointer to routine to draw window contents 


$BA 














wReserved 




Long— Reserved for use by Window Manager; do not use 


$BE 














wStructRgn 




Long— Handle to window's structure region 


$C2 














wContRgn 




Long-PIandle to window's content region 


$C6 














wUpdateRgn 




Long— Handle to window's update region 


$CA 














wCtls 




Long— Handle to first control in window's control chain 


$CE 














wFrameCtls 




Long— Handle to first control in window's frame 


$D2 














wFrame 




Word— Flags for window 


$D4 


• wCustom 

i 


: Array— Additional data for window definition procedure 

i 
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wRe served 



wFrame 



fTitle 

fClose 

f Alert 

fRScroll 

fBScroll 

fGrow 

fFlex 

f Zoom 

fMove 

finfo 

f Zoomed 



A new data field reserved by Apple Computer, Inc. for future 
expansion. 

A bit flag, containing flags specifying the window frame. All of the bits 
in this flag are described in Chapter 25, "Window Manager," in 
Volume 2 of the Toolbox Reference. Some of these bits may be used by 
window definition procedures. The following table lists the bits that 
may be used by window defProcs. 

bit 15 
bit 14 
bit 13 
bit 12 
bit 11 
bit 10 
bit 9 
bits 
bit? 
bit 4 
bit 1 
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Task record 

Figure 52-2 defines the new format for the task record. This new record layout includes 
several new fields, each of which is set by TaskMaster every time your program calls 
TaskMaster. For information on the old fields, see Chapter 25, "Window Manager," in the 
Toolbox Reference. 

TaskMaster will still accept old-format task records; however, if your program uses any of 
the new TaskMaster features (see wmTaskMask), it must use the new record layout. 



Chapter 52 Window Manager Update 52-17 



Apple IIGS Toolbox Reference, Volumes 



Beta Draft 



■ Figure 52-2 Task Record definition 



$00 




vnnWhat 




Word— Same as before 


$02 














winMessage 




Long— Same as before 


$06 














wmWhen 




Long— Same as before 


$0A 














wmWhere 




Long— Same as before 


$0E 




wmModiflers 




Word— Same as before 


$10 














wmTaskData 




Long— Same as before 


$14 














wmTaskMask 




Long— Flags controlling TaskMaster function 


$18 












- 


wmLastClickTlck 




Long— System tick value at last mouse dick 


$1C 




wmClickCount 




Word— Type of last dick (single double, triple) 


$1E 














winTaskData2 




Long— Additbnal TaskMaster retum data 


$22 














wmTaskData3 




Long— Additional TaskMaster retum data 


$26 














vniiTaskData4 




Long— Additional TaskMaster retum data 


$2A 














wmLastClickPt 




Point— Locatton of last mouse dick 
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taskMask 



Flag controlling TaskMaster function: 



Reserved bits 21-31 

tmldleEvents bit 20 



tmMultiClick bit 19 



tmControlMenu bit 18 



tmControlKey bit 17 



tmContentControls 



bit 16 



tminf o 



tmlnactive 



tmCRedraw 



tmSpecial 



bit 15 



bit 14 



bit 13 



bit 12 



Must be set to 

Controls whether TaskMaster sends idle events to the 
target control in the active window: 
1 - Send idle events 

- Do not send idle events 

Controls whether TaskMaster returns multiclick 
information in the Task Record: 

1 - Return multiclick information 

-Do not return multiclick information 

Controls whether TaskMaster passes menu events to 
controls in the active window: 

1 - Pass menu events 

- Do not pass menu events 

Controls whether TaskMaster passes key events to 
controls in the active window: 

1 - Pass key events 

- Do not pass key events 

Controls whether TaskMaster calls Findcontroi 
and TrackControi when Findwindow retums 
winContent and the window is already selected: 

1 - Track the control 

- Do not track the control 

Controls whether TaskMaster activates the window 
when the user clicks in the info bar: 

1 - Do not activate the window 

- Activate the window 

Controls whether TaskMaster retums winactMenu 
when the user selects an inactive menu item: 

1 - Return WinactMenu 

- Never retum winactMenu 

Controls whether TaskMaster redraws controls 
whenever an activate event occurs: 

1 - Redraw controls 

- Do not redraw controls 

Controls whether TaskMaster handles special menu 
items (those with IDs < 256): 

1 - Handle special menu items 

- Do not handle special menu items 
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tmScroll bit 11 

tmGrow bit 10 

tmZoom bit 9 

tmClose bit 8 

tmContent bit? 

tmDragW bit 6 

tmSysClick bit 5 

tmOpenNDA bit 4 

tmMenuSel bit 3 

tmFindW bit 2 



Controls whether TaskMaster enables scrolling and 
activates inactive windows when the user clicks on 
the scroll bar: 
1 - Enable scrolling 

- Do not enable scrolling 

Controls whether TaskMaster calls Growwindow 
when the user drags the size box: 

1 - Call GrowWindow 

- Do not call Growwindow 

Controls whether TaskMaster calls Trackzoom when 
the user clicks in the zoom box: 

1 - Call TrackZoom 

- Do not call TrackZoom 

Controls whether TaskMaster calls TrackcoAway 
when the user clicks in the close box: 

1 - Call TrackGoAway 

- Do not call TrackGoAway 

Controls whether TaskMaster activates the window 
when the user clicks in the content region: 

1 - Activate window 

- Do not activate window 

Controls whether TaskMaster calls Dragwindow 
when the user drags in the drag region: 

1 - Call Dragwindow 

- Do not call Dragwindow 

Controls whether TaskMaster calls Systemciick 
when the user clicks in the system window: 

1 - Call SystemClick 

- Do not call SystemClick 

Controls whether TaskMaster calls openNDA when the 
user selects a desk accessory: 

1 - Call OpenNDA 

- Do not call OpenNDA 

Controls whether TaskMaster calls MenuSeiect 
when the user clicks in the menu bar: 

1 - Call MenuSeiect 

- Do not call MenuSeiect 

Controls whether TaskMaster calls Findwindow for 
mouse-down events: 

1 - Call Findwindow 

- Do not call Findwindow 
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tmupdate bit 1 Controls whether TaskMaster handles update events: 

1 - Handle update events 

- Do not handle update events 
tmMenuKey bit Controls whether TaskMaster calls MenuKey to 

handle menu key equivalents: 

1- Call MenuKey 

- Do not call Menukey 
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New Window Manager calls 

The following tool calls have been added to the Window Manager since publication of the 
first two volumes of the Apple IIGS Toolbox Reference. 



AlertWindow $590E 

Creates an alert window that displays a message referred to by alertStrRef. The message 
can be either a C or a Pascal string, as specified by alertFlags. The subStrPtr parameter 
points to an array of substitution strings for use with substitution characters. For more 
detailed information, see "Alert Windows" eariier in this chapter. 

Parameters 

Stack before call 



Previous contents 



Space 



alertFlags 



subStrPtr 



- alertStrRef - 



Word— Space for result 
Word— Flag word for call 

Long— Pointer to substitution array 

Long— Reference to alert stnng-alertFlags indicates type 

<— SP 



Stack after call 



Previous contents 



Result 



Word— Button number selected 
<— SP 



Errors 



None 
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C extern pascal Word AlertWindow (alertFlags, 

subStrPtr, alertStrRef ) ; 

Word alertFlags; 
Pointer subStrPtr; 
Long alertStrRef; 

alertFlags Contains flags that indicate the type of strings referenced by 

alertStrRef, as well as the type of reference contained that field: 

Reserved bits 3-15 Must be set to 

ref erenceType bits 1-2 Indicate the type of reference stored in alertStrRef. 

00 - alertStrRef \s a pointer 

01 - alertStrRef \s a handle 

10 - alertStrRef \s, a resource ID 
stringType bit Indicates type of string referred to by alertStrRef 

- C string (null-terminated) 

1 - Pascal string 
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CompileText $600E 

Combines source text provided by your program with either custom or standard strings to 
compile a result text string. For successful calls, this call allocates and correctly sizes a 
handle to the result text string, That result string is a simple character array. Your program 
must extract length infonnation for the string from the handle. Note that your program 
must dispose of this handle. 

Control sequences in the source text direct the system to embed eidier custom or 
standard strings into the result text string. These control sequences consist of two ASCII 
characters: a flag character followed by a digit. The flag character indicates whether the 
desired substitution string is custom or standard. 

For standard strings, the flag character is #, The digit following the flag character selects 
one of the following strings: 

#0 OK 
#1 Cancel 
#2 Yes 
#3 No 
#4 Try Again 
#5 Quit 
#6 Continue 

For custom strings, the flag character is *, CompileText obtains custom strings from a 
substitution array built by your program and provided to the system in the parameters for 
this call. The character following the flag charaaer specifies which string to extract. Valid 
values for this character lie in the range o through 9. Thus, a control sequence of * o would 
access the first string in your custom substitution array. 

In order to include either of the flag characters as text in your compiled text, follow the 
flag character with a second flag character (for example, ** results in * in the compiled 
text string). 
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Parameters 

Stack before call 



Previous contents 



Space 



subType 



- subStringsPtr - 



- srcStringPtr - 



srcSize 



Stack after call 



Long— Space for result 

Word— Type of custom substitution strings 

Long— Pointer to substitution array 

Long— Pointer to source string 

Word— Length of source string pointed to by srcStringPtr 

<— SP 



Previous contents 



- stringHandle - 



Errors 
C 



subType 


1 



Long— Handle to result string 
<— SP 

$0E04 compiieTooLarge Compiled text is larger than 64k 

extern pascal Handle CompileText (subType, 

subStringsPtr, srcStringPtr, srcSize) ; 

Word subType, srcSize; 

Pointer subStringsPtr, srcStringPtr; 

Indicates the type of strings stored in the substitution array pointed 
to by subStringsPtr. 

Array contains C strings 
Array contains Pascal strings 

Note that this field is ignored if your program does not use any 
custom substitution strings. 
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subStringsPtr Contains a pointer to your custom text substitution array. This array 
contains from 1 to 10 long pointers to either C or Pascal strings (use 
subType to indicate which type of string you have used). Embedded 
control sequences in your source text direct the system to extract a 
specific string from this array. Note that the system does not verify 
string specifications against the size of this array; be careful to define 
the correct number of string pointers in this array. 

Note that this field is ignored if your program does not use any 
custom substitution strings. 
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DrawInfoBar $550E 

Redraws the info bar of the window specified by grafPortPtr. The method used to redraw 
the info bar's interior is the routine specified by the wInfoDefProc field of the 
paramList passed to Newwindow when the window is created. The Window Manager 
will automatically clip info bar drawing to the dimensions of the info bar, and to the 
visible region of the window. 

Parameters 

Stack before call 



Previous contents 



- grafPortPtr - 



Long— Pointer to GrafPort for window 
<— SP 



Stack after call 



Prwious contents 



<— SP 



Errors 
C 



None 



extern pascal void DrawInfoBar (grafPortPtr) 
Pointer grafPortPtr; 
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EndFrameDrawing $5B0£ 

Restores Window Manager variables after a call to startFrameDrawing. 
Parameters This call has no input or output parameters. The stack is unaffected. 
Errors None 

C extern pascal void EndFrameDrawing () ; 
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ErrorWindow $620E 

Creates a dialog box displaying an error message for a specified error code. GS/OS error 
codes are listed along with standard message text in "Error messages" later in this chapter. 

Each error message is in alert string format and may require a substitution string (see "Alert 
windows" earlier in this chapter for message format and text substitution information). 
The system retrieves the error messages from a resource file of type $8020. The resource ID 
for each message is formed as follows: 

high-order word $07FF 
low-order word error number 

The default error messages are stored in the system resources file.You may assert custom 
error message text by defining and opening another resource file containing type $8020 
resources with appropriate resource IDs assigned to each error message. Make sure that 
your resource file precedes the system resource file in the Resource Manager's search 
sequence. A custom error message resource file need not define substitute messages for 
all possible GS/OS errors; if the Resource Manager does not find a message in your file, it 
will continue through the standard resource search sequence. 

If ErrorWindow receives an undefined error code, it displays a dialog box with the 
"Unknown Error" message ($72). 

Parameters 

Stack before call 



Previous contents 



Space 



subType 



- subStringPtr 



errNutn 



Stack after call 



Word— Space for result 

Word— Type of custom substitution string 

Long— Pointer to substitution string 

Word— GS/OS error number 
<— SP 



Previous contents 



buttonNumber 



Word— Number of button pressed by the user 
<— SP 
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Errors 
C 



Resource Manager errors 



subType 


1 



returned unchanged 



extern pascal Word ErrorWindow (subType, 
subStringPtr, errNum) ; 

Word subType, errNum; 

Pointer subStringPtr; 

Indicates the type of string pointed to by subStringPtr. 



C string 
Pascal string 

Note that this field is ignored if the specified error message does not 
use any substitution strings. 

subStringPtr Contains a pointer to your custom text substitution string. 

Note that this field is ignored if the specified error message does not 
use any substitution strings. 
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GetWindowMgrGlobals $580£ 

Returns a pointer to the Window Manager global data area. 



▲ Warning An application should never make this call 



Parameters 

Stack before call 



Previous contents 



Space 



Stack after call 



Long— Space for result 
<— SP 



Previous contents 



- globalDataPtr 



Errors 
C 



None 



Long— Pointer to the global data area 
<— SP 



extern pascal Pointer GetWindowMgrGlobals () ; 
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NewWindow2 $6lO£ 

Performs the same function as Newwindow, but allows you to specify the input window 

template as a resource (type rWindParaml or rWindParam2). See 

Appendix E, "Resource Types," later in this book for complete descriptions of all resource 

types. 

♦ Note. If you have specified the window template as a resource, then the references 
withm that template to title, color table, and control list must also be resources (or 
NIL). 



♦ Note. In order to create an InfoBar with Newwindow2 using a window template 
defined as a resource, you must specify a NIL inf oDraw procedure in the input 
template and create an invisible window. After issuing the Newwindow2 call, set the 
inf oDraw routine by calling setinf oDraw, then make the window visible with the 
ShowWindow tool call. 

Parameters 

Stack before call 



Previous contents 




Space 


Long— Space for result 


titlePtr 


Long— Pointer to replacement title 


refCon 


Long— RefCon to replace value in template 


- contentDrawPtr - 


Long— Pointer to replacement content draw Routine 


- defProcPtr - 


Long— Pointer to replacement window definition procedure 


paramTableDesc 


Word— Indicates type of reference in paramTableRef 


- paramTableRef - 


Long— Reference to window template 


resourceType 


Word— Resource type of template referred to by paramTableRef 



<— SP 
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Stack after call 



Previous contents 



- graJPortPtr - 



Long— Pointer to window GrafPort; NIL if unsuccessful 
<— SP 



Errors 



Resource Manager errors 
Memory Manager errors 
Window Manager errors 

Control Manager errors 



returned unchanged 
returned unchanged 
returned unchanged from 

NewWindow 

returned unchanged from 

NewControl2 



C extern pascal Pointer NewWindow2 (titlePtr, refCon, 

contentDrawPtr, defProcPtr, 
paramTableDesc, paramTableRef , 
resourceType) ; 

Word paramTableDesc, resourceType; 

Pointer titlePtr, contentDrawPtr, defProcPtr; 
Long refCon, paramTableRef; 

titlePtr, refCon, contentDrawPtr, defProcPtr 

Newwindow2 will replace the values supplied in the template referred 
to by paramTableRef m\h the contents from these fields, allowing you 
to use a standard template and tailor it to create different windows. 
To prevent Newwindow2 from replacing the template values, supply 
NIL pointers in titlePtr, contentDrawPtr, and defProcPtr. 

paramTableDesc Indicates the type of reference stored in paramTableRef 

paramTableRef contains a pointer to a window template 
paramTableRef contims a handle to a window template 
paramTableRef contzins the resource ID of a window template 

Reference to a window template. The paramTableDesc field defines 
the type of reference stored here. The resourceType field defines the 
resource type for the template. The template must comply with the 
format specification of resource type rwindParami or 
rwindParam2 (even if the template is not stored as a resource). See 
Appendix E, "Resource Types," in this book for information on the 
format and content of these resources. 



$0000 
$0001 
$0002 

paramTableRef 
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resourceType Specifies the type of window template referred to by paramTableRef. 

This value should be set correctly even if paramTableRef does not 
contain a resource ID. Valid values are: 

$800E rWindParaml 
$800F rWindParam2 
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ResizeHindow $5C0£ 

Moves, resizes, and draws the window specified by graJPortPtr. The reciP/r parameter is a 
pointer to the window's content region. The hiddenFlag parameter is a Boolean 
parameter; a TRUE value specifies that those portions of the window that are covered 
should not be drawn. If the value is FALSE, the entire window is drawn, covered or not. 

Parameters 

Stack before call 



Previous contents 



hiddenFlag 



rectPtr 



- grafPortPtr 



Stack after call 



Word— Boolean; whether to hide covered area 
Long— Pointer to new content rectangle 

Long— Pointer to window's GrafPort 
<— SP 



Previous contents 



Errors 
C 



None 



<— SP 



extern pascal void ResizeWindow (hiddenFlag, rectPtr, 
grafPortPtr) ; 

Word hiddenFlag; 

Pointer rectPtr, grafPortPtr; 
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Star'tFrameDrawing $5A0E 

Sets up Window Manager data to draw a window frame. Should be called only by window 
definition procedures. Must be balanced by a call to EndFrameOrawing when drawing is 
completed. 

Parameters 

Stack before call 



Previous contents 



- windowPtr 



Stack after call 



Long— Pointer to window to draw 
<— SP 



Previous contents 



Errors 
C 



<— SP 
None 

extern pascal void StartFrameDrawing (windowPtr) ; 
Pointer windowPtr; 
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TaskMasterContent $5D0E 

Internal routine that handles events inside the content region of a window, TaskMaster 
invokes this routine if the tmcontentcontrois bit of the taskMask field of the task 
record is set to 1. Your program should never issue this call. 

Pseudo-code: 

if tmContentControls in wmTaskMask = 1 

if mousedown in content region of frontmost window 

set wmTaskData2, wmTaskDataS, and wmTaskData4 to $00000000 
call FindControl 

put resulting partCode into low-order word of wmTaskDataS 
put controlHandle into wmTaskData:2 
if partCode <> 

call GetCtllD 

put resulting control ID into wmTaskData4 
call TrackControl with actionProcPtr set to $FFFFFFFF 
if result <> or part code corresponds to scroll bar 
put resulting partCode into high-order word of 
wmTaskData3 

if the control is a check box or radio button 
Set or clear the value, as appropriate 

endif 

return (wInControl) 

endif 

set low word of wmTaskData = wInControl 
return (nullEvt) 

endif 

else 

set wmTaskData = pointer to window 
return (wInContent) 

endif 

endif 

TaskMasterContent calls FindControl. If the user did not press the button in a 
control, then the routine returns a result code of winContent, indicating that the mouse 
is in the content region of the window. 

If the user did press the mouse button in a control, TaskMasterContent calls 
TrackControl, directing the Control Manager to use the appropriate action procedure 
for the control. 
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When TrackControi returns, TaskMasterContent examines the part code. If the 
part code is set to 0, then the user decided not to use the control (released the mouse 
button outside the control). TaskMasterControi returns a result code of nuiiEvt 
($0000). 

If the part code is non-zero, then the user released the mouse button within a control. 
TaskMasterContent returns a result COde of wInControl, wmTaskData2 contains 
the control handle, wmTaskoataS (low-order word) contains the part code identifying 
the control in which the user pressed the mouse button, wmTaskoataS (high-order word) 
contains the part code identifying the control where the user released the mouse button, 
and wmTaskData4 contains the control ID (if there is one defined). 
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TaskMasterDA $5F0E 

This call is the TaskMaster entry point for desk accessories. Your program passes event 
information obtained from the Desk Manager. 

Parameters 

Stack before call 



Previous contents 



Space 



eventMask 



- taskRecPtr - 



Word— Space for result 
Word— Not used 

Long— Pointer to extended Task Record 
<— SP 



Stack after call 



Previous contents 



taskCode 



Errors 
C 



Word— TaskMaster result code 
<— SP 



None 



extern pascal Word TaskMasterDA (eventMask, 
taskRecPtr) ; 
Pointer taskRecPtr; 



Word 



eventMask; 
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TaskMasterKey $5£0£ 



Internal routine that handles keystroke events inside the content region of a window. 
Your program should never issue this caU. 



Pseudo-code: 

if tiriMenuKey in wmTaskMask =1 
if wmTaskData = 



(menu did not take keystroke) 



if tmlnactive in vraiTaskMask =1 

if high word of wmTaskData <> 

set low word of wmTaskData = 

set high word of wmTaskData = ID of selected 

inactive menu item 
return (wInActMenu) 

endif 

goto CheckControls 



Call SendEventToCtl with targetOnlyFlag = TRUE 
if result <> 

set wmTaskData2 = handle of control that 

took keystroke 
set wmTaskDataS = result code from defProc 
set wmTaskData4 = ID of control that took 
keystroke 

dim the menu title for selected menu item 
set low word of wmTaskData = 

wlnControlMenu 
return (nullEvt) 



set low word of wmTaskData = ID of selected menu 
item 

set high word of wmTaskData = ID of menu from 

which selection was made 
return (wInMenuBar) 



endif 



else 



(menu did take keystroke) 
if low word of wmTaskData > 255 

if tmControlMenu in wmTaskMask = 1 



endif 



endif 
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elseif low word of wmTaskData < 250 
if tmOpenNDA in wmTaskMask = 

set low word of wmTaskData = ID of selected menu 
item 

set high word of wmTaskData = ID of menu from 

which selection was made 
return (wInDeskltem) 

endif 

call OpenNDA 

dim menu title for selected menu item 
set low word of wmTaskData = wInDeskltem 
return (nullEvt) 
elseif tmSpecial of wmTaskMask = 

set low word of wmTaskData = ID of selected menu item 
set high word of wmTaskData = ID of menu from which 

selection was made 
return (wInSpecial) 
elseif top window is an application window 
if tmControlMenu of wmTaskMask = 1 

call SendEventToCtl with targetOnlyFlag = TRUE 
if result <> 

set wmTaskData2 = handle of control that 

took keystroke 
set wmTaskDataS = result code from defProc 
set wmTaskData4 = ID of control that took 
keystroke 

dim the menu title for selected menu item 
set low word of wmTaskData = 

wInControlMenu 
return (nullEvt) 

endif 

endif 

set low word of wmTaskData = ID of selected menu item 
set high word of wmTaskData = ID of menu from which 

item was selected 
return (wInSpecial) 
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elseif low word of wmTaskData = 250, 251, 252, 253, or 254 
call SystemEdit 
if SystemEdit returns FALSE 

set low word of wmTaskData = ID of selected menu 
item 

set high word of wmTaskData = ID of menu from 

which item was selected 
return (wInSpecial) 

endif 

dim menu title for menu item. that was selected 
set low word of wmTaskData = wCalledSysEdit 
return (nullEvt) 
elseif low word of wmTaskData = 255 

call CloseNDAbyWinPtr for top window 

dim menu title for menu item that was just selected 

set low word of wmTaskData = wClosedNDA 

return (nullEvt) 

endif 

endif 

endif 

CheckControls : 

if tmControlKey in wmTaskMask = 1 

set wmTaskData2, wmTaskData3, and wmTaskData4 = 
if there is a front window 

call SendEventToCtl with targetOnlyFlag = FALSE 
if result <> 

set wmTaskData2 = handle of control that took the 
keystroke 

set wmTaskDataS = result from defProc 
set wmTaskData4 = ID of control that took the 
keystroke 

set wmTaskData = window containing control 
if control is a check box or radio button 
set the ctlValue for the control 

endif 

return (wInControl) 

endif 

endif 

return (keyDownEvt or autoKeyEvt) 

endif 
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TaskMasterKey first checks to see if menu keys are to be passed to the Menu Manager. 
If so, TaskMasterKey calls MenuKey. If the user entered a menu keystroke, MenuKey 
handles it and TaskMasterKey returns control to the calling application. 

If the user did not enter a menu key equivalent or if keystrokes are not to be passed to 
the Menu Manager, TaskMasterKey looks for a control in the active window that wants 
the keystroke. If a control takes the event, TaskMasterKey returns nuiiEvt to the 
calling application. Otherwise, TaskMasterKey returns keyDownEvt, indicating that 
the keystroke is for the application. 



GDRPrivate $540E 

This is an internal Window Manager call; your program should never issue this call. 
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Error messages 

This section documents the error numbers and accompanying messages produced by the 
Errorwindow tool call. For each error number, the following table specifies the message 
text displayed in the dialog box, the icon shown, and the button(s) available for the user 
to press. Any required substitution strings are shown in the message text. 



Error (Hex) 


Message 


Icon 


Button 


Son 




None 


OK 


$01 


■RaH ^\7<?'t"p>Tn fall nuTntit^ir 


None 


OK 


$04 


Invalid Darameteir count. 


None 


OK 


$07 


/Ofi alr^^adv active 


None 


OK 


$10 


Dtf^vi ce not found 


None 


OK 


$11 


Invalid device numbsir- 


None 


OK 


$20 


Bad request or demand. 


None 


OK 


$21 


Bad control or status code. 


None 


OK 


$22 


Bad call parameter. 


None 


OK 


$23 


Character device not open. 


None 


OK 


$24 


Character device already open. 


None 


OK 


$25 


Interrupt table full. 


None 


OK 


$26 


Resources not available. 


None 


OK 


$27 


I/O error. 


None 


OK 


$28 


Device not connected. 


None 


OK 


$29 


Driver is busy and not available. 


None 


OK 


$2B 


Device is write protected. 


None 


OK 


$2C 


Invalid byte count. 


None 


OK 


$2D 


Invalid block number. 


None 


OK 


$2E 


Disk has been switched. 


None 


OK 


$2F 


Device off -line/no media present. 


None 


OK 


$40 


Invalid pathname syntax. 


None 


OK 


$43 


Invalid reference number. 


None 


OK 


$44 


Subdirectory does not exist. 


None 


OK 


$45 


Volume not found. 


None 


OK 


$46 


File not found. 


None 


OK 


$47 


Duplicate pathname. 


None 


OK 


$48 


Volume full. 


None 


OK 


$49 


Volume directory full. 


None 


OK 
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$4A Version error. None OK 

$4B Bad storage type. None OK 

$4C End of file encountered. None OK 

$4D Position out of range. None OK 

$4E Access not allowed. None OK 

$4F Buffer too small. None OK 

$50 File is already open. None OK 

$51 Directory error. None OK 

$52 Unknown volume type. None OK 

$53 Parameter out of range. None OK 

$54 Out of memory. None OK 

$57 Duplicate volume name. None OK 

$58 Not a block device. None OK 

$59 Specified level is outside legal range 

None OK 

$5A Block number too large. None OK 

$5B Invalid pathnames for change_path. None OK 

$5C Not an executable file. None OK 

$5D Operating system not supported. None OK 

$5F Stack overflow. None OK 

$60 Data unavailable. None OK 

$6l End of directory has been reached. None OK 

$62 Invalid FST call class. None OK 

$63 File does not contain requested resource. 

None OK 
$64 Specified FST is not present in system 

None OK 
$65 FST does not handle this type of call 

None OK 
$66 FST handled call, but result is weird 

None OK 

$67 Internal error. None OK 

$68 Device list is full. None OK 

$69 Supervisor list is full. None OK 

$70 Cannot expand file, resource already exists. 

None OK 
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$71 


Cannot add resource fork to this type of file. 






None 


OK 


$72 


Unknown error: [error String. None 


Cancel 


$80 


Error creating the new directory: [reOSOtl String. 






Stop 


Cancel 


$81 


Error saving the file: [reoson String. Stop 


Cancel 


$82 


Insufficient access privileges to open that folder. 




Stop 


OK 


$83 


The selected folder cannot be opened: [reOSOtl String^. 






olOp 


v^ancei 


$84 


You cannot replace a folder with a file. 






Stop 


Cancel 


$85 


That file already exists. Stop 


Cancel 






Replace 


$86 


Insufficient memory to perform that operation. 






About [number String\K additional needed Stop 


Cancel 


$87 


Initialization failed: Disk write protected. 






Stop 


Cancel 


$88 


The pathname is too long. Stop 


OK 


$89 


The disk is write protected. Caution 


Cancel 


$8A 


The disk is full. Stop 


Cancel 


$8B 


The disk directory is full. Stop 


Cancel 


$8C 


The file is copy-protected and can't be copied. 






Stop 


Cancel 


$8D 


Memory is full. Stop 


OK 


$8E 


There isn't enough memory remaining to complete 


this 




operation. Please close some windows and try again. 




Stop 


OK 


$8F 


The item is locked and can't be renamed. 






Stop 


Cancel 


$90 


An I/O error has occurred while using the disk. 






Stop 


Cancel 


$91 


This disk seems to be damaged Stop 


Cancel 


$92 


Not a ProDOS disk. Stop 


OK 


$93 


No on-line volumes can be found. Stop 


OK 


$94 


Insert the disk: [name String]. Swap 


Cancel 
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Appendix E Resource Types 



This appendix documents the format and content of standard resources 
used by the Apple IIGS toolbox. The resources are discussed in 
alphabetical order by resource type name. 
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rAlertString $8015 

Figure E-1 defines the layout of resource type rAiertstring ($8015). Resources of this 
type define the data for Alert Windows to be displayed by the Aiertwindow Window 
Manager tool call. For more complete information on Alert Window definitions, see 
Chapter 52, "Window Manager Update," earlier in this book. 



■ Figure E-1 Alert string, type rAiertstring ($8015) 

Aiertwindow accepts a reference to a string that contains its message, and a reference 
to an array of substitution strings. The substitution strings can be any of seven standard 
strings (such as "OK", "Continue", and so on) or can be specified by the application and 
stored in the buffer to which the substitution-string pointer refers. 



$00 1 i 

'■ alertstring '■ Array 

i i 



alertstring Defines the alert message to be displayed. Contents of this string must 
comply with the rules for Alert Window definitions documented in 
Chapter 52, "Window Manager Update," earlier in this book. 
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rControlList $8003 

Figure E-2 defines the layout of resource type rControiList ($8003). The Control 
Manager stores lists of resource IDs in resources of this type. 

■ Figure E-2 Control List, type rControiList ($8003) 



$00 I 1 

: ctiList : Array of longs 

i i 



ctiList List of resource IDs for control template definitions. The last entry 

must be set to ML. 
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rControlTemplate $8004 

Resources of type rControiTempiate ($8004) define control templates, used with the 
Control Manager NewControi2 tool call to create controls. You fill a type 
rControlTemplate resource according to the needs of the particular control you want 
to create. The system distinguishes between different control templates by examining the 
procRef field in the standard header portion that precedes each template. 
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Control template standard header 

Each control template contains the standard header, which consists of seven fields. 
Following that header, some templates have additional fields, which further define the 
control to be created. The format and content of the standard template header is shown 
in Figure E-3. 

Custom control definition procedures establish their own item template layout. The only 
restriction placed on these templates is that the standard header be present and well 
formed. Custom data for the control procedure may follow the standard header. 



■ Figure E-3 Control template standard header 



$00 




pCount — 




$02 












ID - 


Long 


$06 












rect 


Rectangle 


$0E 












procRef — 


Long 


$12 




flag 


WOTd 


$14 




raoreFlags — 


Word 


$16 












refCon — 


Long 











pCount Count of parameters in the item template, not including the pCount 

field. Minimum value is 6, maximum value varies depending upon the 
type of control template. 
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ID Sets the ctiiD field of the control record for the new control. The 

ctiiD field may be used by the application to provide a 
straightforward mechanism for keeping track of controls. The control 
ID is a value assigned by your application, which the control "carries 
around" for your convenience. Your application can use the ID, which 
has a known value, to identify a particular control. 

rect Sets the ctiRect field of the control record for the new control. 

Defines the boundary rectangle for the control. 

procRef Sets the ctiProc field of the control record for the new control. This 

field contains a reference to the control definition procedure for the 
control. The value of this field is either a pointer to a control 
definition procedure, or the ID of a standard routine. The standard 
values are: 



simpleButtonControl 


$80000000 


Simple button 


checkControl 


$82000000 


Check box 


iconButtonControl 


$07FF0001 


Icon button 


editLineControl 


$83000000 


LineEdit 


listControl 


$89000000 


List 


pictureControl 


$8D000000 


Picture 


popUpControl 


$87000000 


Pop-up 


radioControl 


$84000000 


Radio control 


scrollBarControl 


$86000000 


Scroll bar 


growControl 


$88000000 


Size box 


statTextControl 


$81000000 


Static Text 


editTextControl 


$85000000 


TextEdit 
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flag A word used to set both ctiHiiite and ctiFiag in the control 

record for the new control. Since this is a word, the bytes for 
ctiHiiite and ctiFiag are reversed. The high-order byte of flag 
contains ctiHiiite, while the low-order byte contains ctiFiag. 
The bits in flag are mapped as follows: 

Highlight bits 8-15 Indicates highlighting style: 

Control active, no highlighted 
parts 

1-254 Part code of highlighted part 
255 Control inactive 
Invisible bit 7 Governs visibility of control: 

- Control visible 

1 - Control invisible 

Variable bits 0-6 Values and meaning depends upon 

control type 
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moreFlags 



Used to set the ctiMoreFiags field of the control record for the 
new control. 

The high-order byte is used by the Control Manager to store its own 
control information. The low-order byte is used by the control 
definition procedure to define reference types. 

The defined Control Manager flags are; 



fCtlTarget 



$8000 



fCtlCanBeTarget $4000 
fCtlWantEvents $2000 



fCtlProcRefNotPtr 



$1000 



fCtlTellAboutSize 



$0800 



fCtllsMultiPart $0400 



If set to 1, this control is currently the target of any 

typing or editing commands. 

If set to 1 then this control can be made the target 

control. 

If set to 1 then this control can be called when events 
are passed via the sendEventToCti Control 
Manager call. Note that, if the f ctiCanBeTarget 
flag is set to 1, this control will receive events sent to 
it regardless of setting of this flag. 

If set to 1, then Control Manager expects ctiProc 
to contain the ID of a standard control procedure. If 
set to 0, then c tip roc contains a pointer to the 
custom control procedure. 

If set to 1, then this control needs to be notified 
when the size of the owning window has changed. 
This flag allows custom control procedures to resize 
their associated control images in response to 
changes in window size. 

If set to 1, then this is a multipart control. This flag 
allows control definition procedures to manage multi- 
part controls (necessary since the Control Manager 
does not know about all the parts of a multi-part 
control). 
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The low-order byte uses the following convention to describe 
references to color tables and titles (note, though, that some control 
templates do not follow this convention): 



titlelsPtr 

titlelsHandle 

titlelsResource 

colorTablelsPtr 

colorTablelsHandle 

colorTablelsResource 



$00 Title reference is by pointer 

$01 Title reference is by handle 

$02 Title reference is by resource ID 

$00 Color table reference is by pointer 

$04 Color table reference is by handle 

$08 Color table reference is by resource ID 



re f Con 



Used to set the ctiRef Con field of the control record for the new 
control. Reserved for application use. 
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Keystroke equivalent information 

Many of these control templates allow you to specify keystroke equivalent information 
for the associated controls. Figure E-4 shows the standard format for that keystroke 
information. 



■ Figure E4 Keystroke equivalent record layout 

$00 I keyl I Byte 

$01 key2 Byte 

$02 _ iceyModifiers - Word 
_ keyCareBits - Word 



keyl This is the ASCII code for the upper or lower case of the key 

equivalent. 

key2 This is the ASCn code for the lower or upper case of the key 

equivalent. Taken with keyl, this field completely defines the values 
against which key equivalents will be tested. If only a single key code 
is valid, then set keyl and key2 to the same value. 

keyModif iers These are the modifiers that must be set to 1 in order for the 

equivalence test to pass. The format of this flag word corresponds to 
that defined for the event record in Chapter?, "Event Manager," in 
Volume 1 of the Toolbox Reference. Note that only the modifiers in the 
high-order byte are used here. 

keyCareBits These are the modifiers that must match for the equivalence test to 
pass. The format for this word corresponds to that for 
keyModif iers. This word allows you to discriminate between 
double-modified keystrokes. For example, if you want Control-7 to 
be an equivalent, but not Option-Control-7, you would set the 
controlKeyhil in keyModif iers and both the optionKey znd the 
controlKeyhils in keyCareBits to 1. If you want Return and Enter 
to be treated the same, the keyPad bit should be set to 0. 
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Simple button control template 

Figure E-5 shows the template that defines a simple . button control. 



■ Figure E-5 Item template for simple button controls 



$00 


_ 


pCount 




Word— Parameter count for template: 7, 8, or 9 


$02 


- 




- 








ID 




Lons — Annlication-assiffned rontrol ID 


$06 














rect 




Rectangle— Boundary rectangle for control 


$0E 


- 












procRef 




Long— simpleButtonControl=$80000000 


$12 




flag 




Word— Highlight and contrd flags for control 


$14 




moreFlags 




Word— Additional control flags 


$16 














refCon 




Long— Application-defined value 


$1A 














titleRef 




Long— Reference to title for button 


$1E 














*colorTableRef 




Long— Reference to color table for control (optional) 


$22 










1 




*)ceyEquivalent 




Block, 6 bytes— Keystroke equivalent data (optional) 
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Defined bits for flag are 



Reserved 
ctllnvis 
Reserved 
Button type 



bits &-15 
bit? 
bits 2-6 
bits 0-1 



Defined bits formoreFiags are 



fCtlTarget 
fCtlCanBeTarget 
fCtlWantsEvents 
fCtlProcNotPtr 

fCtlTellAboutSize 
Reserved 

Color table reference 



bit 15 
bit 14 
bit 13 
bit 12 
bit 11 
bits 4-10 
bits 2-3 



Title reference 



bits 0-1 



Must be set to 
l=invisible, 0= visible 
Must be set to 
Describes button type: 

= single-outlined round-cornered button 

1 = bold-outlined round-cornered button 

2 = single-outlined square-cornered button 

3 = single-outlined square-cornered drop-shadowed 
button 



Must be set to 
Must be set to 

Set to 1 if button has keystroke equivalent 
Must be set to 1 
Must be set to 
Must be set to 

Defines type of reference in coiorTabieRef . See 
Chapter 4, "Control Manager," in Volume 1 of the 
Toolbox Reference for the definition of the simple 
button color table. 

00 - color table reference is pointer 

01 - color table reference is handle 

10 - color table reference is resource ID 

11 - invalid value 

Defines type of title reference in titieRef ; 

00 - title reference is pointer 

01 - title reference is handle 

10 - title reference is resource ID 

11 - invalid value 



keyEquivaient Keystroke equivalent information stored at key Equivalent is 
formatted as shown in Figure E-4. 
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Check box control template 

Figure E-6 shows the template that defines a ched box control. 



■ Figure E-6 Control template for check box controls 



$00 




pCount 




Word— Parameter count for template: 8, 9, or 10 


$02 




ID 




iA}ng — Appucaiion-assigEieci coiuroi uj 


$06 


rect 


Rectangle— Boundary reaangle for control 


$0E 




procRef 




Long— checkBoxControl =$82000000 


$12 




flag 




Word— HigMight and contrd flags fw ccxitrd 


$14 




moreFlags 




Wad— Additional control flags 


$16 




re f Con 




Long— Application-defmed value 


$1A 




titleRef 




Long— Jleference to title for box 


$1E 




initial Value 




Word— Initial box setting: for dear, 1 for checked 


$20 




*colorTableRef 




Long— Reference to color table for control (optional) 


$24 


*keyEquivalent 

i 


: Block, 6 bytes— Keystroke equivalent data (optional) 

i 



Defined bits for flag are 

Reserved bits 8-15 Must be set to 

ctiinvis bit 7 1-invisible, 0=visible 

Reserved bits 0-6 Must be set to 
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Defined bits formoreFiags are 



fCtlTarget bit 15 

fCtlCanBeTarget bit 14 

fCtlWantsEvents bit 13 

fCtlProcNotPtr bit 12 
fCtlTellAboutSize 

Reserved bits 4-10 

Color table reference bits 2-3 



Must be set to 
Must be set to 

Set to 1 if check box has keystroke equivalent 
Must be set to 1 
bit 11 Must be set to 
Must be set to 

Defines type of reference in coiorTabieRef (see 
Chapter 4, "Control Manager," in Volume 1 of the 
Toolbox Reference for the definition of the check box 
color table) 

00 - color table reference is pointer 

01 - color table reference is handle 

10 - color table reference is resource ID 

11 - invalid value 

Title reference bits 0-1 Defines type of title reference in titieRef : 

00 - title reference is pointer 

01 - title reference is handle 

10 - title reference is resource ID . 

11 - invalid value 

key-Equivalent Keystroke equivalent information stored at keyEquivaient is 
formatted as shown in Figure E-4. 
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Icon button control template 

Figure E-7 shows the template that defines an icon button control. For more information 
about icon button controls, see "Icon button control" in 
Chapter 28, "Control Manager Update," earlier in this book. 



■ Figure E-7 Control template for icon button controls 



$00 




pCount 




Word— Parameter count for template: 7, 8, 9, 10, or 11 


$02 




ID 




Long— Applicatbn-assigned control ID 


$06 


rect 


Rectangle— Boundary reaangle for control 


$0E 














procRef 




Inno ironBiil-t-onr'onl-rol =Jn7FFfl001 


$12 




flag 




Word— Highlight and control flags for'control 


$14 




moreFlags 




Wad— Additional control flags 


$16 














re f Con 




Long— Application-defined value 


$1A 














iconRef 




Long— Reference to icon for ccmtrol 


$1E 














♦tltleRef 




Long— Reference to title for control (optional) 


$22 














*colorTableRef 




Long— Reference to color table for control (optional) 


$26 




•displiyMode 




Word— Bit flag controlling icon appearance (optional) 


$28 


*keyEquivalent 


Block, 6 bytes— Key equivalent infomiation (optional) 
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Defined bits for flag are 



ctiHiiite bits 8-15 Sets the ctiHiiite field of the control record 

ctiinvis bit 7 l»invisible, 0=visible 

Reserved bits 5-6 Must be set to 

showBorder bit 2 1-No border, 0=Show border 

buttonType bits 0-1 Defines button type: 

00 - single-outlined round-cornered button 

01 - bold-outiined round-cornered button 

10 - single-outlined square-cornered button 

11 - single-outlined square-cornered and drop- 
shadowed button 



Must be set to 
Must be set to 
Must be set to 
Must be set to 1 



Defined bits formoreFiags are 

fCtlTarget bit 15 

fCtlCanBeTarget bit 14 

fCtlWantsEvents bit 13 

fCtlProcNotPtr bit 12 

fCtlTellAboutSize 

bit 11 Must be set to 
Reserved bits 6-10 Must be set to 

Icon reference bits 4-5 Defines type of icon reference in iconRef : 

00 - icon reference is pointer 

01 - icon reference is handle 

10 - icon reference is resource ID 

11 - invalid value 

Color table reference bits 2-3 Defines type of reference in coiorTabieRef ; the 

color table for an icon button is the same as that for a 
simple button (see Chapter 4, "Control Manager," in 
Volume 1 of the Toolbox Reference for the definition 
of the simple button color table) 

00 - color table reference is pointer 

01 - color table reference is handle 

10 - color table reference is resource ID 

11 - invalid value 

Title reference bits 0-1 Defines type of title reference in titieRef : 

00 - title reference is pointer 

01 - title reference is handle 

10 - title reference is resource ID 

11 - invalid value 
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titleRef 



displayMode 



Reference to the title string, which must be a Pascal string. If you are 
not using a title but are specifying other optional fields, set 
moreFiags bits and 1 to 0, and set this field to zero. 

Passed direcdy to the Drawicon routine, and defines the display 
mode for the icon. The field is defined as follows (for more 
information on icons, see Chapter 17, "QuickDraw II Auxiliary," in 
Volume 2 of the Toolbox Reference): 

Defines the background color to apply to black part 
of black-and-white icons, 

Defines the foreground color to apply to white part 
of black-and-white icons. 
Must be set to 

1"AND light-gray pattern to image being copied 
0»Don't AND the image 
1-Copy light-gray pattern instead of image 
0=Don't copy light-gray pattem 
1 -Invert image before copying 
0=Don't invert image 

Color values (both foreground and background) are indexes into the 
current color table. See Chapter l6, "QuickDraw II," in Volume 2 of the 
Toolbox Reference for details about the format and content of these 
color tables. 

keyEquivaient Keystroke equivalent information stored at keyEquivaient is 
formatted as shown in Figure E-4. 



Background Color 


bits 12-15 


Foreground Color 


bits 8-11 


Reserved 


bits 3-7 


of f Line 


bit 2 


openlcon 


bit 1 


selectedlcon 


bitO 
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LineEdit control template 

Figure E-8 shows the template that defines a LineEdit control. For more information 
about LineEdit controls, see "LineEdit control" in Chapter 28, "Control Manager Update," 
earlier in this book. 



■ Figure E-8 Control template for LineEdit controls 



$00 




pCount 




Word— Parameter count for template: 8 


$02 






- 








ID 




Long— Application-assigned control ID 


$06 














rect 




Rectangle— Boundary rectangle for control 


$0E 














procRef 




Long— editLineControl -$83000000 


$12 




flag 




Word— Highlight and control flags for control 


$14 




moreFlags 




Word— Additional control flags 


$16 














re f Con 




Long— Application-defined value 


$1A 




maxSlze 




Word— Maximum length of input line (in bytes) 


$1C 














defaultRef 




Long— Reference to default text 













Defined bits for flag are 

Reserved bits 8-15 Must be set to 

ctiinvis bit 7 l=invisible, 0=visible 

Reserved bits 0-6 Must be set to 
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Must be set to 
Must be set to 1 
Must be set to 1 
Must be set to 1 

Must be set to 
Must be set to 

Defines type of text reference in def auitRef 

00 - text reference is pointer 

01 - text reference is handle 
10 - text reference is resource ID 
11 -invalid value 

maxsize Specifies the maximum number of characters allowed in the LineEdit 

field. Valid values lie in the range from 1 to 255. 

The high-order bit indicates whether the LineEdit field is a password 
field. Password fields protect user input by echoing asterisks, rather 
than the actual user input. If this bit is set to 1, then the LineEdit field 
is a password field. 

Note that LineEdit controls do not support color tables. 



Defined bits for moreFiags are 

fCtlTarget bit 15 

fCtlCanBeTarget bit 14 
fCtlWantsEvents bit 13 
fCtlProcNotPtr bit 12 
fCtlTellAboutSize 

bit 11 

Reserved bits 2-10 

Text reference bits 0-1 
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List control template 

Figure E-9 shows the template that defines a list control. For more information about list 
controls, see "List control" in Chapter 28, "Control Manager Update," earlier in this book. 



■ Figure E-9 Control template for list controls 



$00 




pCount 




woru~~*r<uHiiicicr cuuiii loi tciiipiiiic. i*i ui ij 


$02 














ID 




Long— Application-assigned control ID 


$06 














rect 




Rectangle— Boundary rectangle for control 


$0E 














procRef 


_ 


($OE)Long— listControl =$89000000 


$12 




flag 




Word— Highlight and control flags for control 


$14 




moreFlags 




woru — AQuiuonai coniroi nags 


$16 














ref Con 




Long— Application-defined value 


$1A 


— 


listsize 




Word— Number of members in list 


$1C 




listView 




Word— Number of members visible in window 


$1E 




list Type 




Word— Type of list entries, selection options, etc. 


$20 




liststart 




Word-^irst visible list member 


$22 














listDraw 




Long— Pointer to member drawing routine 


$26 




listMemHeight 




Word— Height of each list item (in pixels) 


$28 




listMemSize 




Word— Size of list entry (in bytes) 


$2A 














listRef 




Long— Reference to list of member records 


$2E 














*colorTableRef 




Long— Reference to color table for control (optional) 
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Defined bits for flag are 



Reserved 

ctllnvis 

Reserved 



bits 8-15 Must be set to 
bit 7 1 "invisible, 0= visible 
bits 0-6 Must be set to 



Defined bits for mo reF lags are 

fCtlTarget bit 15 

f CtlCanBeTarget bit 14 
fCtlWantsEvents bit 13 
fCtlProcNotPtr bit 12 
fCtlTellAboutSize 

bit 11 

fCtllsMultiPart bit 10 

Reserved bits 4-9 

Color table reference bits 2-3 



List reference 



Must be set to 
Must be set to 
Must be set to 
Must be set to 1 

Must be set to 
Must be set to 1 
Must be set to 

Defines type of reference in coiorTabieRef (the 
color table for a List control is described in 
Chapter 11, "List Manager," in Volume 1 of the 
Toolbox Reference) 

00 - color table reference is pointer 

01 - color table reference is handle 

10 - color table reference is resource ID 

11 - invalid value 

bits 0-1 Defines type of reference in listRef (the format 
for a list member record is described in 
Chapter 11, "List Manager," in Volume 1 of the 
Toolbox Reference) 

00 - list reference is pointer 

01 - list reference is handle 

10 - list reference is resource ED 

11 - invalid value 
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listType 



Valid values for listType are as follows: 



Reserved 

fListScrollBar 



fListSelect 



fListString 



bits3-15 Must be set to 0. 

bit 2 Allows you to control where the scroll bar for the list is 
drawn; 

1 - Scroll bar drawn on inside of boundary rectangle. 
The List Manager calculates space needed, adjusts 
dimensions of boundary rectangle, and resets this 
flag. 

- Scroll bar drawn on outside of boundary rectangle, 
bit 1 Controls type of selection options available to the 

user: 

1 - Only single selection allowed 

- Arbitrary and range selection allowed 

bit Defines the type of strings used to define list items: 

1 - C-strings ($00-terminated) 
- Pascal string 



For details on the remaining custom fields in this template, see the discussion of "List 
Controls and List Records" m Chapter 11, "List Manager," of Volume 1 of the Toolbox 
Reference. 
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Picture control template 

Figure E-10 shows the template that defines a picture control. For more information about 
picture controls, see "Picture control" in Chapter 28, "Control Manager Update," earlier in 
this book. 



Figure E-10 Control template for picture controls 



$00 




pCount 




Word— Parameter count for template: 7 


$02 














ID 




Long— Application-assigned control ID 


$06 


rect 


Rectangle— Boundary rectangle for contrcJ 


$0E 














procRef 




Long— pictureControl =$80000000 


$12 




flag 




Word— Highlight and control flags for control 


$14 




moreFlags 




Word— Additional control flags 


$16 




re f Con 




Long— Application-defined value 


$1A 














pi CtureRef 




Long-Reference to picture for control 



Defined bits for flag are 

ctlHilite 



ctllnvis 

Reserved 



bits 8-15 Specifies whether the control wants to receive mouse 
selection events; the values for ctiHi lite are as 
follows: 

Control is active 

255 Control is inactive 
bit 7 1 "invisible, 0=visible 
bits 0-6 Must be set to 
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Defined bits for moreFiags are 



f CtlTarget bit 15 

fCtlCanBeTarget bit 14 

fCtlWantsEvents bit 13 

fCtlProcNotPtr bit 12 
fCtlTellAboutSize 

Reserved bits 2-10 

Picture reference bits 0-1 



Must be set to 

Must be set to 

Must be set to 

Must be set to 1 

bit 11 Must be set to 

Must be set to 

Define type of picture reference in pictureRef : 

00 - invalid value 

01 - reference is handle 

10 - reference is resource ID 

11 - invalid value 
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Pop-up control template 

Figure E-11 shows the template that defines a pop-up control. For more information 
about pop-up controls, see "Pop-up control" in Chapter 28, "Control Manager Update," 
earlier in this book. 



■ Figure E-11 Control template for pop-up controls 







pCount 




Wad— Parameter count for template: 9 or 10 


$02 














ID 


- 


Lraig— Application-assigned control ID 


i\JO 














reot 




Rectangle— Boundary rectangle for control 


$0E 














procRef 




Long— popUpCorit rol =$87000000 


$12 




flag 




Word— Highlight and control flags for control 


$14 




moreFlags 




Word— Additional control flags 


$16 














refCon 




Long— Application-defined value 


$1A 




titleWldth 




Word— Width in pixels of title string area 


$1C 














menuRef 




Long— Reference to menu definition 


$20 




inltialValue 




WcM-d— Item ID of initial item 


$22 














*coiorTableRef 




Long— Reference to color table for control (optional) 
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Defined bits for flag are 



ctlHilite 



bits 8-15 



ctllnvis 
fType2PopUp 



bit? 
bit 6 



fDontHiliteTitle bit 5 



fDontDrawTitle bit 4 



fDontDrawResult bit 3 



f InWindowOnly bit 2 



Specifies whether the control wants to receive mouse 
selection events; the values for ctiHiiite are as 
follows: 

Control is active 
255 Control is inactive 
1 -invisible, 0=visible 

Tells the Control Manager whether to create a pop-up 
menu with white space for scrolling (see 
Chapter 37, "Menu Manager Update," for details on 
Type 2 pop-up menus): 

1 - Draw pop-up with white space (Type 2) 

- Draw normal pop-up 

Controls highlighting of the control title: 

1 - Do not highlight title when control is popped up 

- Highlight title 

Allows you to prevent the title from being drawn 
(note that you must supply ia title in the menu 
definition, whether or not it will :be displayed); if 
titiewidth is defined and this bit is set to 1, then 
the entire menu is offset to the right by titiewidth 
pixels: 

1 - Do not draw the title 

- Draw the title 

Allows you to control whether the selection is drawn 
in the pop-up rectangle: 

1 - Do not draw the result in the result area after a 
selection 

- Draw the result 

Controls the extent to which the pop-up menu can 
grow; this is particularly relevant to Type 2 pop-ups 
(see Chapter 37, "Menu Manager Update," for details 
on Type 2 pop-up menus): 

1 - Keep the pop-up in die current window 
- Allow die pop-up to grow to screen size 



f Right JustifyTitle 
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bit 1 Controls title justification: 

1 - Right justify the title; note that if the title is right 
justified, then the control rectangle is adjusted to 
eliminate unneeded pixels, the value for 
titiewidth is also adjusted 
- Left justify the title 



f Right JustifyResult 
bitO 



Defined bits for moreFiags are 

fCtlTarget bit 15 

fCtlCanBeTarget bit 14 
fCtlWantsEvents bit 13 

fCtlProcNotPtr bit 12 
fCtlTellAboutSize 

bit 11 

Reserved bits 5-10 

Color table reference bits 3-4 



fMenuDef IsText 



Controls result justification: 

1 - Right justify the selection 

- Left justify the selection titiewidth pixels from 

the left of the pop-up rectangle. 



Must be set to 
Must be set to 

Must be set to 1 if the pop-up has any keystroke 
equivalents defined 
Must be set to 1 

Must be set to 
Must be set to 

Defines type of reference in coiorTabieRef (the 
color table for a menu is described in 
Chapter 13, "Menu Manager," in Volume 1 of the 
Toolbox Reference) 

00 - color table reference is pointer 

01 - color table reference is handle 

10 - color table reference is resource ID 

11 - invalid value 

bit 2 Defines type of data referred to by menuRef : 

1 - menuRef is a pointer to a text stream in NewMenu 
format (see Chapter 13, "Menu Manager," in Volume 1 
of the Toolbox Reference for details) 
- menuRef is a reference to a Menu Template 
(again, see Chapter 13, "Menu Manager," in Volume 1 
of the Toolbox Reference for details on format and 
content of a Menu Template) 
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Menu reference bits 0-1 Defines type of menu reference in menuRef (if 

fMenuDef isText is Set to 1, then these bits are 
ignored): 

00 - menu reference is pointer 

01 - menu reference is handle 

10 - menu reference is resource H) 

11 - invalid value 

rect Defines the boundary rectangle for the pop-up and its tide, before die 

menu has been "popped" by die user. The Menu Manager will calculate 
the lower, right coordinates of die rectangle for you, if you specify 
those coordinates as (0,0). 

initiaivaiue The initial value to be displayed for die menu. The initial value is die 
default value for die menu, and is displayed in die pop-up rectangle of 
"unpopped" menus. You specify an item by its ID, tkt is, its relative 
position within the array of items for the menu (see 
Chapter 37, "Menu Manager Update," for information on the layout 
and content of die pop-up menu template). If you pass an invalid 
item ID dien no item is displayed in die pop-up rectangle. 

titiewidth Provides you widi additional conti^ol over placement of die menu on 
die screen. The titiewidth field defines an offset from the left 
edge of die conti'ol (boundary) rectangle to die left edge of die pop- 
up rectangle. If you are creating a series of pop-up menus and you 
want diem to be vertically aligned, you can do this by giving all menus 
die same xl coordinate and titiewidth value. You may use 
titiewidth for tilis even if you are not going to display die tide 
(fDontDrawTitle flag is settO 1 in flag). If yoU set titiewidth 
to 0, then die Menu Manager determines its value based upon the 
lengdi of the menu tide, and the pop-up rectangle immediately follows 
die tide stiing. If die actual widdi of your tide exceeds die value of 
titiewidth, results are unpredictable. 

menuRef Reference to menu definition (see Chapter 13, "Menu Manager," in 

Volume 1 of die Toolbox Reference md 

Chapter 37, "Menu Manager Update," in diis book for details on menu 
templates). The type of reference contained in menuRef is defined 
by the menu reference bits in mo reFi ags . 
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Radio button control template 

Figure E-12 shows the template that defines a radio button control: 



■ Figure E-12 Control template for radio button controls 



$00 


- 


pCount 


- 


Word— Parameter count for template: 8, 9, or 10 


$02 


- 












ID 




Ir>nff— Annliriittnn-iJ^<;ioTipH rontrnl TD 


$06 














rect 




Rectangle— Boundary rectangle for control 


$0E 














procRef 




Long— radioButtonControl =$84000000 


$12 




flag 




Word— Highlight and control flags for control 


$14 




moreFlags 




Word— Additional control flags 


$16 














re fCon 




Long— Application-defined value 


$1A 














tltleRef 




Long— Reference to title for button 


$1E 




inltialValue 




>X(ord— Initial setting: for dear, 1 for set 


$20 














•colorTableRef 




Long— Reference to color table for control (optional) 


$24 














♦keyEquivalent 




Block, 6 bytes— Keystroke equivalent data (optional) 



Defined bits for flag are 

Reserved bits 8-15 Must be set to 

ctiinvis bit 7 1 "invisible, 0=visible 
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Family number bits 0-6 Family numbers define associated groups of radio 

buttons; radio buttons in the same family are logically 
linked, that is, setting one radio button in a family 
clears all other buttons in the same family 

Defined bits for moreFiags are as follows; 



fCtlTarget bit 15 

fCtlCanBeTarget bit 14 

fCtlWantsEvents bit 13 

fCtlProcNotPtr bit 12 

fCtlTellAboutSize 

bit 11 

Reserved bits 4-10 

Color table reference bits 2-3 



Must be set to 
Must be set to 

Set to 1 if button has keystroke equivalent 
Must be set to 1 

Must be set to 
Must be set to 

Defines type of reference in coiorTabieRef (see 
Chapter 4, "Control Manager," in Volume 1 of the 
Toolbox Reference for the definition of the radio 
button color table) 

00 - color table reference is pointer 

01 - color table reference is handle 

10 - color table reference is resource ID 

11 - invalid value 

Defines type of title reference in titieRef : 

00 - title reference is pointer 

01 - title reference is handle 

10 - title reference is resource ID 

11 - invalid value 

keyEquivaient Keystroke equivalent information stored at keyEquivaient is 
formatted as shown in Figure E-4. 



Title reference 



bits 0-1 
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Scroll bar control template 

Figure E-13 shows the template that defines a scroll bar control: 



■ Figure E-13 Control template for scroll bar controls 



$00 




pCount 




Word— Parameter count for template: 9 or 10 


$02 














ID 




T/vio Ann!ir!)tirtn-!i^?iofipH ronfrn! IT) 


$06 














rect 




Rectangle— Boundary rectangle for control 


V/i-t 














procRef 




Long— scrollControl =$86000000 


$12 




flag 




Wad— Highlight and control flags for control 


$14 




moreFlags 




Word— Additional control flags 


$16 














re f Con 




Long— Application-defined value 


$1A 




maxsize 




Word— Initial size of displayed item 


$1C 




viewSlze 




Word— Amount of item initially visible 


$1E 




initialValue 




Wcffd— Initial setting 


$20 














♦colorTableRef 




Long— Reference to color table for control (optional) 
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Defined bits for flag are 



Reserved 
ctllnvis 

Reserved 

horScroll 

rightFlag 

leftFlag 

downFlag 

upFlag 



bits 8-15 
bit? 
bits 5-6 
bit 4 
bits 
bit 2 
bit 1 
bitO 



Must be set to 
l=invisible, 0=visible 
Must be set to 

1-horizontal scroll bar, 0=vertical scroll bar 
1-bar has right arrow, 0-bar has no right arrow 
l=bar has left arrow, 0=bar has no left arrow 
1-bar has down arrow, 0-bar has no down arrow 
1-bar has up arrow, 0-bar has no up arrow 



Note that extraneous flag bits are ignored, based upon state of horscroii flag. For 
example, for vertical scroll bars, rightFlag and lef tFiag are ignored. 



Defined bits for moreFiags are 

fCtlTarget bit 15 

fCtlCanBeTarget bit 14 
fCtlWantsEvents bit 13 
fCtlProcNotPtr bit 12 
fCtlTellAboutSize 

bit 11 

Reserved bits 4-10 

Color table reference bits 2-3 



Reserved 



bits 0-1 



Must be set to 
Must be set to 
Must be set to 
Must be set to 1 

Must be set to 
Must be set to 

Defines type of reference in colorTableRef (see 
Chapter 4, "Control Manager," in Volume 1 of the 
Toolbox Reference and "Clarifications" in 
Chapter 28, "Control Manager Update," earlier in this 
book for the definition of the scroll bar color table) 

00 - color table reference is pointer 

01 - color table reference is handle 

10 - color table reference is resource ID 

11 - invalid value 
Must be set to 
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Size box control template 

Figure E-14 shows the template that defines a size box control: 
■ Figure E-14 Control template for size box controls 



$00 




pCount 




Word — Parameter count for template: 6 or 7 
















ID 






$06 














rect 




Rectangle— Boundary rectangle for control 


$0E 














prooRef 




Long— growControl =$88000000 


$12 




flag 




Word— Highlight and control flags for control 


$14 




moreFlags 




Word— Additional control flags 


$16 














re f Con 




Long— Application-defined value 


$20 














•colorTableRef 




Long— Reference to color table for control (optional) 








•r 





Defined bits for flag are 



Reserved 

ctllnvis 

Reserved 

fCallWindowMgr 



bits &-15 Must be set to 
bit 7 1 -invisible, 0=visible 
bits 1-6 Must be set to 

bit l=call Growwindow and sizewindow to track this 
control 

0=just highlight control 
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Defined bits formoreFiags are 

fCtlTarget bit 15 

fCtlCanBeTarget bit 14 
fCtlWantsEvents bit 13 
fCtlProcNotPtr bit 12 
fCtlTellAboutSize 

bit 11 

Reserved bits 4-10 

Color table reference bits 2-3 



Reserved 



bits 0-1 



Must be set to 
Must be set to 
Must be set to 
Must be set to 1 

Must be set to 
Must be set to 

Defines type of reference in coiorTabieRef (see 
"Error Corrections" in 

Chapter 28, "Control Manager Update," earlier in this 
book for the definition of the size box color table) 

00 - color table reference is pointer 

01 - color table reference is handle 

10 - color table reference is resource ID 

11 - invalid value 
Must be set to 
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Static text control template 

Figure E-15 shows the template that defines a static text control. For more information 
about static text controls, see "Static text control" in 
Chapter 28, "Control Manager Update," earlier in this book. 



■ Figure E-15 Control template for static text controls 



$00 




pCount 




WOTd— Parameter count for template: 7, 8, or 9 


$02 














ID 


- 


LcHig— Applicatbn-assigned control ID 


$06 














rect 




Rectangle-Boundary rectangle for control 


$0E 














prooRef 




Long— statTextControl =$81000000 


$12 




flag 




Word— Highlight and control flags for control 


$14 




morePlags 




Wad— Additional control flags 


$16 














refCon 




Long— Application-defined value 


$1A 














textRef 




Long-Reference to text for control 


$1E 




♦textSlze 




Word— Text size field (optional) 


$a) 




*just 




Word— Initial justificatbn for text (optfonal) 
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Defined bits for flag are 

Reserved bits 8-15 

ctiinvis bit 7 

Reserved bits 2-6 

f SubstituteText bit 1 



f SubTextType 



bitO 



Must be set to 
l=invisible, 0=visible 
Must be set to 

0=no text substitution to perform 
l=there is text substitution to perform 
0=C strings 
1 "Pascal strings 



Defined bits for moreFiags are 



fCtlTarget 
fCtlCanBeTarget 
fCtlWantsEvents 
fCtlProcNotPtr 
fCtlTellAboutSize 



Reserved 
Text Reference 



textSize 



just 



bit 15 Must be set to 

bit 14 Must be set to 

bit 13 Must be set to 

bit 12 Must be set to 1 

bit 11 Must be set to 
bits 2-10 Must be set to 
bits 0-1 Defines type of text reference in textRef : 

00 - text reference is pointer 

01 - text reference is handle 

10 - text reference is resource ID 

11 - invalid value 

The size of the referenced text in characters, but only if the text 
reference in textRef is a pointer. If the text reference is either a 
handle or a resource ID, then the Control Manager can extract the 
length from the handle. 

The justification word is passed on to LETextBox2 (see 
Chapter 10, "LineEdit Tool Set," in Volume 1 of the Toolbox Reference 
for details on the LETextBox2 tool call), and is used to set the initial 
justification for the text being drawn. Valid values for just are 



leftJustify 

centerJustify 1 

rightJustify -1 

fullJustify 2 



Text is left justified in the display window 
Text is centered in the display window 
Text is right justified in the display window 
Text is fully justified (both left and right) in 
the display window 



Static text controls do not support color tables. In order to display text of different 
color, you must embed the appropriate commands into the text string you are displaying. 
See the discussion of LETextBox2 in Chapter 10, "LineEdit Tool Set," in Volume 1 of the 
Toolbox Reference for details on command format and syntax. 
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TextEdit control template 

Figure E-l6 shows the template that defines a TextEdit control. For more information 
about TextEdit controls, see "TextEdit control" in Chapter 28, "Control Manager Update," 
earlier in this book. 



■ Figure E-l6 Control template for TextEdit controls 



$00 




pCount 




Word— Parameter count for template: 7 to 23 


$02 














ID 




Lraig— Application-assigned control ID 


$06 







rect '■ Rectangle— Boundary rectangle for control 



Long— editTextControl =$85000000 

Word— Highlight and control flags for control 
Word— Additional control flags 

Long— Application-defined value 



Long— Specific TextEdit control flags (see below) 
♦indentRect : Rectangle— Defines text indentation from control rea (optional) 









$26 














•vertBar 




Long— Handle to vertical saoll bar for control (optional) 


$2A 




*vert Amount 




Word— Vertical saoll amount, in pixels (optional) 


$2C 














•horzBar 




Long— Reserved; must be set to NILL (optional) 


$30 




•horzAmount 




Word— Reserved; must be set to (optional) 




continued 









$0E 












procRef 




$12 




flag 




$14 




moreFlags 




$16 












re f Con 




$1A 












textFlags 




$1E 
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continued 




$32 














*styleRef 


- 


Long — Reference to initial style infonnation for text (optional) 


$36 




*textDescriptor 




Word — Defines format of initial text and textRef (optional) 


$38 














♦text Re f 




Long— Reference to initial text for edit window (optional) 


$3C 














•textLength 




Long— Length of initial text (optionaO 


$40 














•maxChars 




Long— Maximum number of charaaers allowed (optional) 


$44 














♦maxLines 




I nnt? — ^Rpsf*rvpd_* must bp s^^t to ("ontinnan 


$48 




•maxCharsPerLines 




WUlU — l\C5crVCU, lUUoL uc acl vJ U VOpUOIlAi^ 


$4A 


— *maxHeight — 


Word— Reserved; must be set to (optional) 


$4C 














*colorRef 




Long— Reference to TextEdit color table (optional) 


$50 




*drawMode 




Word— QuickDraw II text mode for edit window (optional) 


$52 














*fllterProcPtr 




Long— Pointer to filter routine for this control (optional) 













Defined bits for flag are 

Reserved bits 8-15 Must be set to 

ctiinvis bit 7 1-invisible, Divisible 

Reserved bits 0-6 Must be set to 
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Defined bits for moreFiags are 



fCtlTarget 

f CtlCanBeTarget 

fCtlWantsEvents 

fCtlProcNotPtr 

fTellAboutSize 



fCtllsMultiPart 

Reserved 

Color table reference 



Style reference 



bit 15 

bit 14 

bit 13 

bit 12 

bit 11 



bit 10 
bits 4-9 
bits 2-3 



bits 0-1 



Must be set to 
Must be set to 1 
Must be set to 1 
Must be set to 1 

If set to 1, a size box will be created in the lower-right 
comer of the window. Whenever the control window 
is resized, the edit text will be resized and redrawn. 
Must be set to 1 | 
Must be set to 

Defines type of reference in coiorRef ; the color 
table for a TextEdit control (TECoiorTabie) is 
described in Chapter 49, "TextEdit," in this book: 

00 - color table reference is pointer 

01 - color table reference is handle 

10 - color table reference is resource ID 

11 - invalid value 

Defines type of style reference in styieRef; the 
format for a TextEdit style descriptor is described in 
Chapter 49, "TextEdit," in this book: 

00 - style reference is pointer 

01 - style reference is handle 

10 - style reference is resource ID 

11 - invalid value 



A Important 



Do not set f TeiiAboutsize to 1 unless the control also has a 
vertical scroll bar. a 



Valid values for textFiags are 

fNotControl bit 31 

f SingleFormat bit 30 
f SingleStyle bit 29 



fNoWordWrap 



bit 28 



Must be set to 
Must be set to 1 

Allows you to restrict the style options available to 
the user: 

1 - Allow only one style in the text 

- Do not restrict the number of styles in the text 
Allows you to control TextEdit word wrap behavior: 

1 - Do not word wrap the text; only break lines on CR 
($0D) characters 

- Perform word wrap to fit the ruler 
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fNoScroll 



fReadOnly 



f SmartCutPaste bit 25 



fTabSwitch 



fDrawBounds 



fColorHilight bit 22 
fGrowRuler bit 21 



bit 27 Controls user access to scrolling; 

1 - Do not allow either manual or auto-scrolling 

- Scrolling permitted 

bit 26 Restricts the text in the window to read-only 

operations (copying from the window will still be 
allowed): 

1 - No editing allowed 

- Editing permitted 

Controls TextEdit support for smart cut and paste 
(see Chapter 49, "TextEdit," for details on smart cut 
and paste support): 

1 - Use smart cut and paste 

- Do not use smart cut and paste 
bit 24 Defines behavior of the Tab key (see 

Chapter 49, "TextEdit," for details): 

1 - Tab to next control in the window 

- Tab inserted in TextEdit document 

bit 23 Tells TextEdit whether to draw a box around the edit 
window, just inside rect; the pen for this box is two 
pbcels wide and one pixel high 

1 - Draw rectangle 

- Do not draw rectangle 
Must be set to 0. 

Tells TextEdit whether to resize the ruler in response 
to the user resizing the edit window; if set to 1, 
TextEdit will automatically adjust the right margin 
value for the ruler: 

1 - Resize the ruler 
- Do not resize the ruler 



fDisableSelection 



fDrawInactiveSelection 

bit 19 



Reserved 



bit 20 Controls whether user can select text: 
1 - User cannot select text 

- User can select text 

Controls how inactive selected text is displayed; 

1 - TextEdit draws a box around inactive selections 
- TextEdit does not display inactive selections 

bits 0-18 Must be set to 
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indentRect Each coordinate of this rectangle specifies the amount of white space 
to leave between the boundary rectangle for the control and the text 
itself, in pixels. Default values are (2,6,2,4) in 640 mode and (2,4,2,2) 
in 320 mode. Each indentation coordinate may be specified 
individually. In order to assert the default for any coordinate, specify 
its value as $FFFF. 

vertBar Handle of the vertical scroll bar to use for the TextEdit window. If you 

do not want a sctoU bar at all, then set this field to NIL. If you want 
TextEdit to create a scroll bar for you, just inside the right edge of the 
boundary rectangle for the control, then set this field to $FFFFFFFF, 

vert Amount Specifies the number of pixels to scroll whenever the user presses the 
up or down arrow on the vertical scroll bar. In order to use the default 
value (9 pixels), set this field to $0000. 

horzBar Must be set tO ML. 

horzAmount MuSt be set tO 0. 

styieRef Reference to initial style information for the text. See the description 
of the TEFormat record in Chapter 49, "TextEdit," for information 
about the format and content of a style descriptor. Bits 1 and of 
moreFiags define the type of reference (pointer, handle, resource 
ID). To use the default style and ruler information, set this field to 
NULL. 



textDescriptor 

Input text descriptor that defines the reference type for the initial 
text (which is in textRef ) and the format of that text. See 
Chapter 49, "TextEdit," for detailed information on text and 
reference formats. 

textRef Reference to initial text for the edit window. If you are not supplying 

any initial text, then set this field to NULL. 

textLength If textRef is a pointer to the initial text, then this field must contain 
the length of the initial text. For other reference types, TextEdit 
extracts the length from the reference itself. 

♦ Note: You must specify or omit the textDescriptor, textRef, and textLength 
fields as a group. 
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maxChars 



maxLines 



Maximum number of characters allowed in the text. If you do not want 
to define any limit to the number of characters, then set this field to 
NULL. 

Must be set to 0. 



maxCharsPerLines 

Must be set to NULL. 

maxHeight MuSt be set tO 0. 

coiorRef Reference to the color table for the text. This is a Text Edit color table 
(see Chapter 49, "TextEdit," for format and content of 
TECoiorTabie). Bits 2 and 3 of moreFiags define the type of 
reference stored here. 

drawMode This is the text mode used by QuickDraw II for drawing text. See 

Chapter 16, "QuickDraw II," in Volume 2 of the Toolbox Reference for 
details on valid text modes. 

fiiterProcPtr Pointer to a filter routine for the control. See Chapter 49, "TextEdit," 
for details on TextEdit generic filter routines. If you do not want to 
use a filter routine for the control, set this field to NIL. 
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rClInputString $8005 

Figure E-17 defines the layout of resource type rci input string ($8005). Resources of 
tliis type contain GS/OS Class 1 input strings (length word followed by data). 



■ Figure E-17 GS/OS classl input string, type rci input st ring ($8005) 



Word 



: length Bytes 
j 



length Indicates the number of bytes stored at stringcharacters. This is 

an unsigned integer; valid values lie in the range from 1 to 65535. 

stringcharacters 

Anay of length characters. 




length 



stringcharacters 
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rClOutputString $8023 

Figure E-18 defines the layout of resource type rcioutputstring ($8023). Resources 
of this type contain GS/OS class 1 output strings (buffer size word and string length word 
followed by data). 

■ Figure E-18 GS/OS classl output string, type rci output string ($8023) 



$00 




bufferSize — 


>J?ord 


$02 




stringLength — 


Word 


$04 







: StringCharacters • String LengthBytes 

i \ 



bufferSize Indicates the number of bytes in the entire sUncture, including 
bufferSize. 

StringLength Indicates the number of bytes stored at stringCharacters. This is 
an unsigned integer; valid values lie in the range from 1 to 65535. If the 
returned string will not fit in the buffer, this field indicates the length 
of the string the system wants to return. Your program should add four 
to that value (to account for bufferSize and stringLength, 

resize the buffer, and reissue the call). 

StringCharacters 

Array of stringLength characters. 
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rCString $801D 

Figure E-19 defines the layout of resource type rCString ($801D). Resources of this 
type contain C strings (null-terminated character array). 

■ Figure E-19 C string, type rest ring ($801D) 



$00 1 1 

• stringCharaoters • BytCS 

i ' 



stringCharacters 

Array of characters; last character must be a null ($00). The string may 
contain up to 65,535 characters, including the null terminator. 
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ricon $8001 

Figure E-20 defines the layout of resource type ricon ($8001). 



Figure 1^20 Icon, type neon ($8001) 



$00 


— iconType — 


Word 


$02 


— IconSize — 


Word 


$04 


— iconHeight — 


Word 


$06 


— IconWldth - 


Word 


$08 


iconlmage 


Array 


$xx 


IconMask 


Array 



iconType Contains flags defining the type of icon stored in the icon record. 

Color Indicator Bit 15 Indicates whether the icon contains a color or 

black-and-white image 
1 - Icon is color 
- Icon is black and white 

iconSize Specifies the size of the icon image stored at iconimage, in bytes. 

iconHeight Specifies the height of the icon, in pixels. 

iconwidth Specifies the width of the icon, in pixels. 

iconlmage Contains iconSize bytes of icon image data. 

iconMask Contains iconSize bytes of mask data to be applied to the image 
located at iconlmage. 



E-46 Apple IIGS Toolbox Reference, Volume 3 



Apple IIGS Toolbox Reference, Volume 3 



Beta Draft 



30 August 1989 



rKTransTable $8021 

Figure E-21 defines the layout of resource type rKTransTable ($8021). Resources of 
this type define keystroke translation tables for use by the Event Manager (see 
Chapter 31, "Event Manager Update," eariier in this book for complete information on the 
format and content of resources of this type). 



■ Figure E-21 Keystroke translation table, type rKTransTable ($8021) 



$000 I 1 

: transTable '■ 256 Bytcs— Keystroke translation array 



$100 I I 

: deadKeyTable \ XX Bytcs— Dead-key Validation array 



$100i-xx 

: repiacementTabie '■ yy Bytcs—Dcad-key replacement array 

i i 



transTable This is a packed array of bytes used to map the ASCII codes produced 
by the keyboard into die character value to be generated. Each cell in 
the array directly corresponds to the ASCII code that is equivalent to 
the cell offset. For example, the transTable cell at offset $0D (13 
decimal) contains the character replacement value for keyboard code 
$0D, which, for a straight ASCII translation table, is a Return character 
(CR). The transTable cells from 128 to 255 ($80 to $FF) contain 
values for Option-key sequences (such as Option-S). 
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deadKeyTable 



This table contains entries used to validate dead keys. Dead key 
refers to keystrokes used to introduce multikey sequences that result 
in single characters. For example, pressing Option-u followed by e 
yields an e with an umlaut. There is one entry in deadKeyTable for 
each defined dead key. The last entry.must be set to $0000. Each entry 
must be formatted as follows: 



deadKey 



offset 



Byte— Character code for dead key 

Byte— Offset from deadKeyTable into replacement Table 



deadKey Contains the character code for the dead key. The system uses 

this value to check for user input of a dead key. The system 
compares this value with the first user keystroke. 

offset Byte offset from beginning of deadKeyTable into relevant 

subarray in repiacementTabie, divided by 2. The system 
uses this value to access the valid replacement values for the 
dead key in question. 

repiacementTabie 

This table contains the valid replacement values for each dead key 
combination. This table is made up of a series of variable-length 
subarrays, each relevant to a particular dead key. The last entry in each 
sub-array must be set to $0000. Each entry in the 
repiacementTabie must be formatted as follows: 



deadKey 



offset 



Byte— Character code for dead key 

Byte— Offset from deadKeyTable into repiacementTabie 



scanKey 



replaceValue 



Contains a valid character code for dead key replacement. The 
system uses this field to determine whether the user entered a 
valid dead key combination. The system compares this value 
with the second user keystroke. 

Contains the replacement value for the character specified in 
scanKey for this entry. The system delivers this value as the 
replacement for a valid dead key combination. 
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rListRef $801C 

Figure E-22 defines the layout of the array element that comprises resource type 
rListRef ($801C). Resources of this type define members of list controls (see 
Chapter 28, "Control Manager Update," earlier in this book for more information on list 
controls). A single rListRef resource may contain more than one of these elements; you 
concatenate the elements to form the resource. 



■ Figure E-22 Listmemberreferencearray element, type rListRef ($801C) 




$04 
$05 



item 



- Long— Pointer to list string 



Byte— Control flags for list member 

Array- Listmemberclata;(listMemSize - 5 ) bytes of data 



J 



itemPtr 

iten^'lag 

memSelect 



Reserved 

item 



Pointer to the list member string. 
Control flags for the member. 

Bits 6-7 Indicates whether the item is selected 

00 - Item is enabled but not selected 

01 - Item is disabled (cannot be selected) 

10 - Item is selected 

11 - Invalid value 
Bits 0-5 Must be set to 

Application-specific data for the list member. The listMemsize 
field of the list control template specifies the size of this field, plus 5. 
For example, in order to assign a two-byte tag to each list member, 
you would set listMemSize to 7 (5+2) and place the tag value at 
item in each list member. 
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rMenu 



$8009 



Figure E-23 defines the layout of resource type rMenu ($8009). Resources of this type 

define parameters to some new Menu Manager tool calls. See 

Chapter 37, "Menu Manager Update," earlier in this book for more information. 



Figure E-25 Menu template, type rMenu ($8009) 



$00 
$02 
$04 



$0A 



— version 




Word— Version number for template; must be set to 


— menu ID 




Word— Menu ID 


— menuFlag 




Word— Menu flag word 


— menuTltleRef 




Long— Reference to menu title string 













itenoRef Array ] n Longs— References to menu Items 



version 



menuID 



Identifies the version of the menu template. The Menu Manager uses 
this field to distinguish between different revisions of the template. 
Must be set to 0. 

Unique identifier for the menu. See Chapter 13, "Menu Manager," in the 
Toolbox Reference hr information on valid values for menu id. 
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menuFiag Bit flags controlling the display and processing attributes of the menu. 
Valid values for menuFiag are: 

titieRef Type bits 14-15 Defines the type of reference in menuTitieRef : 

00 - Reference is pointer 

01 - Reference is handle 

10 - Reference is resource K) 

11 - Invalid value 
bits 12-13 Defines the type of reference in each entry of 

itemRef Array (all array entries must be of the same 
type): 

00 - References are pointers 

01 - References are handles 

10 - References are resource IDs 

11 - Invalid value 
Must be set to 



itemRef Type 



Reserved bits 9-11 

alwaysCallmChoose 

bits 



disabled 



Reserved 

XOR 



custom 



allowCache 



Reserved 



menuTitieRef 



bit? 



bit 6 
bit 5 



bit 4 



bit 3 



bits 0-2 



Causes the Menu Manager to call a custom menu 
defProc mChoose routine even when the mouse is not 
in the menu rectangle (supported tear-off menus): 

- Do not always call mChoose routine 

1 - Always call mChoose routine 
Enables or disables the menu: 

- Menu enabled 

1 - Menu disabled 
Must be set to 

Controls how selection highlighting is performed: 

- Do not use XOR to highlight 

1 - Use XOR to highlight item 

Indicates whether custom or standard menu: 

- Standard menu 

1 - Custom menu 
Controls menu caching: 

- Do not cache menu 

1 - Menu caching allowed 
Must be set to 



Reference to title string for menu. The titieRef Type bits in 
menuFiag indicate whether menuTitieRef contains a pointer, a 
handle, or a resource ID. If menuTitieRef is a pointer, then the title 
string must be a Pascal string. Otherwise, the Menu Manager can 
retrieve the string length from control information in the handle. 
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itemRef Array Anay of references to the menu items for the menu. The 

itemRef Type bits in menuFiag indicate whether the entries in the 
array are pointers, handles, or resource IDs. Note that all array entries 
must contain the same reference type. The last entry in the array must 
be set to $00000000. 
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rMenuBar $8008 

Figure E-24 defines the layout of resource type rMenuBar ($8008). Resources of this type 
define the characteristics of a menu bar for new Menu Manager tool calls. For more 
information, see Chapter 37, "Menu Manager Update," eariier in this book. 



■ Figure E-24 Menu bar record, type rMenuBar ($8008) 



$00 


— version — 


Word— Version number for template; must be set to 


$02 


— menuFlag — 


Word— Menu bar flag word 


$04 








menuRef Array 


n Longs— References to menus 



J 



version 

menuBarFlag 
menuRef Type 



Reserved 



menuRef Array 



Identifies the version of the menu bar template. The Menu Manager 
uses this field to distinguish between different revisions of the 
template. Must be set to 0. 

Bit flags controlling the display and processing attributes of the menu 
bar. Valid values for menuBarFlag are: 

bits 14-15 Defines the type of reference in each entry of 

menuRef Array (all array entries must be of the same 
type): 

00 - References are pointers 

01 - References are handles 

10 - References are resource IDs 

11 - Invalid value 
bits 0-13 Must be set to 

Array of references to the menus for the menu bar. The menuRef Type 
bits in menuBarFlag indicate whether the entries in the array are 
pointers, handles, or resource IDs. Note that all array entries must 
contain the same reference type. The last entry in the array must be set 
to $00000000. 
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rMenuItem $800A 

Figure E-25 defines the layout of resource type rMenuitem ($800A). Resources of this 

type define menu items to some new Menu Manager tool calls. See 

Chapter 37, "Menu Manager Update," earlier in this book for more information. 



■ Figure E-25 Menu item template, type rMenuitem ($800A) 



$00 




version — 


$02 




itemID — 


$04 
$05 






itemChar 


ItemAltChar 


$06 




itemCheck — 


$08 


— ItemFlag — 


$0A 










ItemTltleRef — 









Word— Versbn number for template; must be set to 
Word— Menu item ID 

Byte— Primary keystroke equivalent character 
Byte— Alternate keystroke equivalent character 

Word— Character code for checked items 



_ Word— Menu item flag word 



version Identifies the version of the menu item template. The Menu Manager 

uses this field to distinguish between different revisions of the menu 
item template. Must be set to 0. 

itemID Unique identifier for the menu item. See Chapter 13, "Menu Manager," 

in the Toolbox Reference for information on valid values for itemiD. 

itemChar, itemAltChar 

These fields define the keystroke equivalents for the menu item. The 
user can select the menu item by pressing the Command key along with 
the key corresponding to one of these fields. Typically, these fields 
contain the upper and lower case ASCII codes for a particular 
character. If you only have a single key equivalence, set both fields 
with that value. 

itemCheck Defines the character to be displayed next to the item when it is 
checked. 
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itemFlag 



titleRef Type 



Reserved 
shadow 



outline 



Reserved 
disabled 



divider 
XOR 

Reserved 

underline 

italic 

bold 

iteitiTitleRef 



Bit flags controlling the display attributes of the menu item. Valid 
values for itemFlag are: 

bits 14-15 Defines the type of reference in itemTitieRef 

00 - Reference is pointer 

01 - Reference is handle 

10 - Reference is resource ID 

11 - Invalid value 
bit 13 Must be set to 

bit 12 Indicates item shadowing: 

- No shadow 

1 - Shadow 

bit 11 Indicates item oudining 

- Not outlined 

1 - Outlined 
bits 8-10 Must be set to 

bit 7 Enables or disables the menu item: 

- Item enabled 

1 - Item disabled 

bit 6 Controls drawing divider below item: 

- No divider bar 

1 - Divider bar 

bit 5 Controls how highlighting is performed: 

- Do not use XOR to highlight 

1 - Use XOR to highlight item 
bits 3-4 Must be set to 

bit 2 Controls item underlining: 

- Do not underline item 

1 - Underline item 

bit 1 Indicates whether item is italicized 

- Not italicized 

1 - Italicized 

bit Indicates whether item is drawn bold: 
- Not bold 
1-Bold 

Reference to tide string for menu item. The titleRef Type bits in 
itemFlag indicate whether itemTitieRef contains a pointer, a 
handle, or a resource ID. If itemTitieRef is a pointer, then the title 
string must be a Pascal string. Otherwise, the Menu Manager can 
retrieve the string length from control information in the handle. 
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rPString $8006 

Figure E-26 defines the layout of resource type rP string ($8006). Resources of this type 
contain Pascal strings. 



Figure E-26 Pascal string, type rP string ($8006) 



$00 
$01 



lengthByte 



Byte 



strlngCharacters • nBytCS 

i 



lengthByte Number of bytes of data stored in stringcharacters array. 

stringCharacters 

Array of lengthByte characters. 
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rResName $8014 

Figure E-27 defines the layout of resource type rResName ($8014). Resources of this type 
define name strings for resources of a given type and ID. The resource H) value assigned to 
an rResName resource must be formed as follows: 

$0001 xxxx where xxxx corresponds to the resource type for resources whose names 
are defined in this resource 

Within the rResName resource you define name strings corresponding to resources with 
specified resource IDs. Names are stored in Pascal strings, and must be unique within the 
appropriate resource type. Resource names are not required, so you may specify names 
for only a few resources within a given type. 



■ Figure E-27 Resource name array, type rResName ($8014) 



$00 


— versNum — 


Word 


$02 












nameCount — 


Long 


$06 







resNames • Array of nameCount Name blocks 



versNum Specifies the resource template version. Must be set to 1. 

nameCount Count of entries in the resNames name definition array. 
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resNames Array of name strings. Each entry must be formatted as follows; 



$00 














namedResID 




Long 


$04 







resName \ PaSCal String 



namedResID ID of the resource for this name. 
resName Name String for the resource. 
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rStringList $8007 

Figure E-28 defines the layout of resource type rStringList ($8007). Resources of this 
type contain an array of Pascal strings. 

■ Figure E-28 Pascal string array, type rstringList ($8007) 

Word 

: AnaycrfPascalstrings(resourcesoftyperPString) 
j 

count Indicates the number of Pascal strings stored at st ri ngs . 

strings An array of count Pascal strings. 



$00 
$02 



strings 
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rText $8016 

Figure E-29 defines the layout of resource type rText ($8016). Resources of this type 
contain text blocks (data arrays with no embedded length information; block length must 
be indicated in other fields). 

■ Figure E-29 Text block, type next ($8016) 



$00 1 ! 

• stringCharacters ■ BytCS 

i j 



StringCharacters 

Array of up to 65,535 characters. Any length information is contained 

in a separately maintained field. 
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rTextBlock $8011 

Figure E-30 defines the layout of resource type rTextBlock ($8011). Resources of this 
type contain text blocks (data arrays with no embedded length information; block length 
must be indicated in other fields). 



■ Figure E-30 Text block, type rTextBlock ($8011) 



$001 I 

• StringCharacters ■ BytCS 

i i 



StringCharacters 

Array of up to 65535 characters. Any length information is contained in 
a separately maintained field. 
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rTextBox2 $800B 

Figure E-31 defines ttie layout of resource type rTextBox2 ($800B). Resources of this 
type contain data formatted as input to the LETextBox2 LineEdit tool call (see 
Chapter 10, "LineEdit Tool Set," in the Toolbox Reference for details). 



■ Figure E-31 LETextBox2 input text, type rTextBox2 ($800B) 



$00 


— length — 


Word 


$02 








StrlngCharacters 


Bytes 



length Indicates the number of bytes stored at strlngCharacters. Valid 

values lie in the range from 1 to 32767. 

StrlngCharacters 

Array of up to 32767 characters. Formatting information is embedded 

in the character array, and is included in the value of length. See 

Chapter 10, "LineEdit Tool Set," in the Toolbox Reference for complete 

information on the syntax for this embedded appearance 

information. 
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rToolStartup $8013 

Figure E-32 defines the layout of resource type nooi startup ($8013). Resources of 
this type define tool set start up records for use with the Tool Locator startupToois 
and shutDownToois tool callsXsee Chapter 51, "Tool Locator Update," earlier in this 
book for more information). 



■ Figure E-32 Tool start stop record, type nooistartup ($8013) 



$00 


— flags 




Word— Flag word— must be set to 


$02 


— videoMode 




Word— Video mode for QuickDraw II 


$04 


— resFilelD 




Word— Set by StartUpTools 


$06 










— dPageHandle 




Long— Set by StartUpTools 


$0A 


— numTools 




Word— Number of entries in toolArray 


$0C 










toolArray 




numTool s ToolSpec records 



videoMode Defines the video mode for QuickDraw II. See 

Chapter l6, "QuickDraw II," in the Toolbox Reference for valid values. 

resFilelD The StartUpTools call setS this field. ShutDownToois requires it 

as input. 

dPageHandle The StartUpTools call sets this field. ShutDownToois requires it 
as input. 
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tooiArray Each entry defines a tool set to be started. The numToois field 

specifies the number of entries in this array. Each entry is formatted as 
follows; 



$00 




toolNumber 




Word— Tool set identifier 


$02 




minVersion 




Word— Minimum acceptable tool set version 



toolNumber Specifies the tool set to be loaded Valid tools set numbers are 
discussed in Chapter 51, "Tool Locator Update," earlier in this 
book. 

tooiversion Specifies the minimum acceptable version for the tool set. See 
Chapter 24, "Tool Locator," in the Toolbox Reference for the 
format of this field. 



E-64 Apple IIGS Toolbox Reference, Volume 3 



Apple IIGS Toolbox Reference, Volume 3 



Beta Draft 



30 August 1989 



rTwoRects $801A 

Figure E-33 defines the layout of resource type rTwoRects ($801A), 
■ Figure E-33 Two rectangles, type rTwoRects ($801 A) 

$00 1 I 

recti : Rectangle 

$08 I I 

: rect2 : Rectangle 

i i 



recti First rectangle. 

rect2 Second rectangle. 
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rWindColor $8010 

Figure E-34 defines the layout of resource type rwindcoior ($8010). Resources of this 
type define window color tables for the Window Manager. 

■ Figure E-34 Window color table, type rwindcoior ($8010) 



$00 




frameColor 




Word 


$02 




titleColor 




Word 


$04 




tBarColor 




Word 


$06 




growColor 




Word 


$08 




InfoColor 




Word 



frameColor Color of the window frame and of the alert frame. 
Reserved bits 8-15 Must be set to 

windowFrame bits 4-7 Color of window frame— value is an index into the 

active color table 
Reserved bits 0-3 Must be set to 

titleColor Colors of inactive title bar, inactive title, and active title: 

Reserved bits 12-15 Must be set to 

inactiveTitieBar bits 8-11 Color of inactive title bars— value is an index into the 

active color table 

inactiveTitie bits 4-7 Color of inactive titles— value is an index into the 

active color table 

activeTitie bits 0-3 Color of active titles, close box, and zoom box- 
value is an index into the active color table. 

tBarColor Color and pattern information for active title bar: 

pattern bits 8-15 Defines pattern for title bar: 

$00 - Solid 
$01 - Dither 
$02 -Lined 

patterncoior bits 4-7 Color for pattern— value is an index into the active 

color table 

backcoior bits 0-3 Background color— value is an index into the active 

color table. 
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growcoior Colof of size box and alert frame's middle outline: 

aiertMidFrame bits 12-15 Color of alert frame middle outline— value is an index 

into the active color table 
Reserved bits 8-11 Must be set to 

sizeunseiected bits 4-7 Color for unselected size box— value is an index into 

the active color table 

sizeseiected bits 0-3 Color for selected size box— value is an index into the 

active color table. 

InfoColor Color of information bar and alert frame's inside oudine: 

aiertMidFrame bits 12-15 Color of alert frame inside outline— value is an index 

into the active color table 

Reserved bits 8-11 Must be set to 

inf oBar bits 4-7 Color for information bar— value is an index into the 

active color table 

Reserved bits 0-3 Must be set to 
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rWindParaml $800E 

Figure E-35 defines the layout of resource type rwindParami ($800E). This resource 
defines a template used to create windows with the Newwinciow2 Window Manager tool 
call (see Chapter 52, "Window Manager Update," earlier in this book). Most of these fields 
correspond to fields in the Newwindow parameter list (defined in the Toolbox Reference). 



■ Figure E-35 Window template, type rwindParami ($8(X)E) 



$00 




plLength 




Word 


$02 




pi Frame 




Word— See NewWindow wFrameBits parameter 


$04 














plTltle 




Long 


$08 














plRef Con 




Long— See NewWindow tvRefCkm parameter 


$0C 







pizoomRect '■ Rectangle— See NewWindow wZoom parameter 











$14 
















plColorTable 




Long 




$18 




plYOrigin 




Word— See NewWindow 


tvYOrigin parameter 


$1A 




plXOrlgin 




Word— See NewWindow 


wiXOrgin parameter 


$1C 




plDataHelght 




Word— See NewWindow 


tfZtotof/parameter 


$1E 




plDataWldth 




WCM'd— See NewWindow 


u)Z3tt<flW parameter 


$20 




plMaxHelght 




Word— See NewWindow 


iwMojrf/parameter 


$22 




plMaxWidth 




Word— See NewWindow 


wMaxW parameter 


$24 




plVerScroll 




Wcffd— See NewWindow 


wScroUVer parameter 


$26 




plHorScroll 




Wcffd— See NewWindow 


wScroUHor parameter 


$28 




plVerPage 




Word--See NewWindow 


tvPageVer parameter 


$2A 




plHorPage 




Word— See NewWindow 


wPageHor paramaer 




continued 
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continued 




$2C 






- 








plInfoText 


- 


Lone — See NewWindow wInfoRefCon oaiameter 


$30 




plInfoHelght 


- 


Word— See NewWindow wlnfoHeight parameter 


$32 






- 








plDef Proc 




Long— See NewWindow wFrameDefProcpmmetei 


$36 






- 








plInfoDraw 




Long— See NewWindow wInfoDefProc paramtter 


$3A 














pIContentDraw 




Long— See NewWiMow wContDefProc parameter 


$3E 














plPosition 




ivcQangic — oee wewninaow wi^wttKy/j pdi<tiucLcr 


$46 














plPlane 




Long— See NewWindow M/Piane parameter 


$4A 














plControlList 




Long 


$4E 




plInDesc 




AX^ord 



pi Length Specifies the number of bytes in the template, including the length of 
piLength. Must be set to $50. 

piTitie Reference to title string for the window. The contents of pi inoesc 

specify the type of reference stored here. The title must be stored in a 
Pascal string, containing both a leading and a trailing space. 

If pi Title is set to NIL, the Window Manager will create a window 
without a title bar. If your program is creating a window with a title 
bar, you must specify a title of some sort. In order to create a window 
without a title, make piTitie (or titlePtr on the Newwindow2 call) 
refer to a null string. 

Note that the Window Manager creates a copy of the title string, so 
that your program can free the memory for this string after issuing the 
NewWindow2 call. 

If you specify a non-NIL value for titlePtr on the Newwindow2 call, 
this field is ignored. 
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piCoiorTabie Reference to the color table for the window. The contents of 
piinDesc specify the type of reference stored here. If 
piCoiorTabie is set to NIL, the Window Manager assumes that 
there is no color table for the window. 

The format of the color table is defined in 
Chapter 25, "Window Manager," in the Toolbox Reference. If 
piCoiorTabie refers to a resource, then the color table must be 
defined in a resource of type rwindcoior . 

picontroiList Reference to the template or templates defining controls for the 

window. The Window Manager passes this value to the NewControi2 
Control Manager tool call as the reference parameter. Note that 
piinDesc contains the data for the NewControi2 referenceDesc 
parameter. Refer to Chapter 28, "Control Manager Update," in this 
book for more information about NewCont roi2. 

If this field is set to NIL, then the Window Manager assumes that there 
is no control list for the window and does not call NewCont r oi 2 . 

piinDesc Defines the type of reference stored in picoiorTabie and 

piTitie. Also contains the referenceDesc vslue for NewControi2 
that defines the contents of picontroiList: 



Reserved 
colorTableRef 



titleRef 



controlRef 



bits 12-15 Must be set to 
bits 10-11 Define the type of reference stored in 
piCoiorTabie: 

00 - Reference is pointer to color table 

01 - Reference is handle to color table 

10 - Reference is resource ID of rwindcoior 
resource 

11 - Invalid value 

bits 8-9 Define the type of reference stored inpiTitie: 

00 - Reference is pointer to Pascal string 

01 - Reference is handle to Pascal string 

10 - Reference is resource ID of rP string resource 

11 - Invalid value 

bits 0-7 Define the type of reference stored in 

picontroiList. Passed directiy to the 
NewCont roi 2 Control Manager tool call as the 
referenceDesc parameter. For valid values, see the 
description of the NewControi2 tool call in 
Chapter 28, "Control Manager Update," earlier in this 
book. 
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rWindParam2 $800F 

Figure E-36 defines the layout of resource type rwindParama ($800F), This resource 
defines a template used to create windows with the Newwindow2 Window Manager tool 
call (see Chapter 52, "Window Manager Update," earlier in this book). Use this template 
for custom windows. 



■ Figure E-36 Window template, type rwinciParam2 ($800F) 



$00 


- p2ListID - 


Word 


$02 








— p2DefProc — 


Long 


$06 








p2Data 


Byte array 



p2ListiD Specifies the resource template version. Must be set to NIL. 

p2DefProc Pointer to the definition procedure for the window. When using the 
rwindParam2 window template, you must pass a pointer to a valid 
definition procedure, either in the template or with the defProcPtr 
parameter to the Newwindow2 Window Manager tool call. On disk, 
this field does not contain a valid value. 

p2Data Window definition data required by the routine pointed to by 

p2Def Proc. The format and content of this field is determined by 
the window defmition procedure. 
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Appendix F 



Delta Guide 



This appendix collects all information that corrects errors or clarifies 
ambiguities in Volumes 1 and 2 of the Toolbox Reference. This 
information was derived from the "Error corrections" and "Clarifications" 
sections of each chapter in this book. This appendix contains a separate 
major section for tool set to be addressed; the sections are presented 
alphabetically, by tool set name. 
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Apple Desktop Bus 

The following sections correct errors or omissions in 

Chapter 3, "Apple Desktop Bus Tool Set," in Volume 1 of the Toolbox Reference. 



Error correction 

The parameter table for the ReadKeyMicroData tool call ($0A09) in Volume 1 of the 
Toolbox Reference incorrectly describes the format for the readconf ig command ($0B). 
The description should be as follows. 

Command datalength Name Action 

$0B 3 readConf ig Read configuration; dataPtr refers to a 

3-byte data structure: 
Byte ADB keyboard and mouse 
addresses 

low nibble - keyboard 
high nibble - mouse 
Byte Keyboard layout and display 
language 

low nibble - keyboard layout 
high nibble - display language 
Byte Repeat rate and delay 
low nibble - repeat rate 
high nibble - repeat delay 

The description of this configuration record is also wrong in the tool set summary. The 
following table shows the correct information. 
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Name Offset Type 

ReadConf igRec (configuration record for 
rcADBAddr $0000 Byte 

rcLayoutOrLang $0001 



rcRepeatDelay $0002 Byte 



Definition 



ReadKeyMicroData) 

ADB keyboard and mouse addresses 

low nibble - keyboard 

high nibble - mouse 

Byte Keyboard layout and 

display language 

low nibble - keyboard layout 

high nibble - display language 

Repeat rate and delay 

low nibble - repeat rate 

high nibble - repeat delay 



Clarification 

This section presents new information about the AsyncADBReceive call. 

You can call AsyncADBReceive to poll a device using register 2, and it will return certain 
useful information about the status of the keyboard. The call returns the following 
information in the specified bits of register 2: 

Bit 5: 0-Caps Lock key down 
1-Caps Lock key up 

Bit 3: 0-Control key down 
1-Control key up 

Bit 2: 0-Shift key down 
1-Shift key up 

Bit 1: 0-Option key down 
1-Option key up 

Bit 0: 0-Command key down 
1-Command key up 
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Control Manager 

The following sections correct errors or omissions in Chapter 4, "Control Manager," in 
Volume 1 of the Toolbox Reference. 



Error corrections 

This section documents errors in Chapter 4, "Control Manager," in Volume 1 of the Toolbox 
Reference. 

■ The color table for the size box control in the Toolbox Reference is incorrect. The 
correct table follows, with new information in boldface. 



growOutline word 


Color of size box's oudine 


Bits 8-15 


- zero 


Bits 4-7 


= outline color 


Bits 0-3 


» zero 


growNorBack WOrd 


Color of interior when not highlighted 


Bits 8-15 


= zero 


Bits 4-7 


= background color 


Bits 0-3 


■= icon color 


growSelBack WOfd 


Color of interior wlien lilghliglited 


Bits 8-15 


= zero 


Bits 4-7 


= background color 


Bits 0-3 


= icon color 



■ On page 4-76 of the Toolbox Reference, in the section that covers the setctiParams 
call, it states tiiat the call "Sets new parameters to the control's definition 
procedure . . This description is misleading; the call does not directly set the 
parameters. Rather, it sends the new parameters to the control's definition procedure, 
unlike setctivaiue, which actually sets the appropriate value in the control record 
and then passes the value on to the definition procedure. 
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Clarifications 

The following items provide additional information about features previously described 
in the Toolbox Reference. 

m The barArrowBack entry in the scroll bar table was never implemented as first 
intended, and is now no longer used. 

■ The Control Manager preserves the current port across Control Manager calls, including 
those that are passed through other tools, such as the Dialog Manager, 

■ The Control Manager preserves the following fields in the port of a window that 



contains controls: 




bkPat 


background pattern 


pnLoc 


pen location 


pnSize 


pen si2e 


pnMode 


pen mode 


pnPat 


pen pattern 


pnMask 


pen mask 


pnVis 


pen visibility 


f ontHandle 


handle of current font 


fontID 


ID of current font 


f ontFlags 


font flags 


txSize 


text size 


txFace 


text face 


txMode 


text mode 


spExtra 


value of space extra 


chExtra 


value of character extra 


f gColor 


foreground color 


bgColor 


background color 



■ The control definition procedures for simple buttons, check boxes, and radio buttons 
can now compute the size of their boundary rectangles automatically. The computed 
size is based on the size of the title string for the button. 

■ To ensure predictable color behavior, you should always align color table-based 
controls on an even pbcel boundary in 640 mode. If you do not do so, the control will 
not appear in the colors you specify, due to the effect of dithering. 
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Dialog Manager 

The following sections correct errors or omissions in Chapter 6, "Dialog Manager," in 
Volume 1 of die Toolbox Reference. 



Error corrections 

This section explains changes that have been made to the Dialog Manager's 
documentation in the Apple IIGS Toolbox Reference. 

m The documentation for setoitemType on page 6-82 of the Toolbox Reference says 
that the call is used to change a dialog item to a different type. In fact, 
SetDi temType should be used only to change the state of an item from enabled to 
disabled or vice versa. 

■ The Dialog Manager does not support dialog item type values of picitem or 
icon I tern, contrary to what the Toolbox Reference states in Table 6-3 on page 6-12. 
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Integer Math Tool Set 

The following section describes a bug that has been fixed in the Integer Math Tool Set. 



Clarifications 

■ The Long2Dec Integer Math tool call now correctly handles input long values that have 
the low-order three bytes set to zero. Previously, if the input long had its low-order 
three bytes set to zero, Long2Dec would always return a zero value, even if the high- 
order byte was non-zero. 
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List Manager 

The following sections correct errors or omissions in Chapter 11, "List Manager," in Volume 
1 of the Toolbox Reference. 



Garificatlons 

■ The Apple IIGS Toolbox Reference states that a disabled item of a list cannot be 
selected. In fact, a disabled item can be selected, but it cannot be highlighted. The 
List Manager provides the ability to select disabled (dimmed) items so that it is 
possible, for instance, for a user to select a disabled menu choice as part of a help 
dialog. To make an item unselectable, set it inactive (see "List Manager definitions" 
later in this chapter). 

■ Any List Manager tool call that draws will change fields in the GrafPort. If you are using 
List Manager tool calls you must set up the GrafPort correctly and save any valuable 
GrafPort data before issuing the call. 

■ Member text is now drawn in l6 colors in both 320 and 640 mode. 

■ Previous versions of List Manager documentation do not cleariy define the relationship 
between the listview, listMemHeight, and listRect fields in the list record. 
To clarify this point, note that the following fomiula must be tme for values in any list 
record: 

listview 'listMemHeight + 2 - listRect.v2 -listRect.vl 

If you set listview to 0, the List Manager will automatically adjust the 
iistRect.v2 field and set the listview field so that this formula holds. Note that 
if you pass a value for listview the bottom boundary of listRect may change 
slightiy. 

list Manager definitions 

The following terms define the valid states for a list item. 

inactive Bit 5 of the list item's memFiag field is set to 1. Inactive items appear 

dimmed and cannot be highlighted or selected. 

disabled Bit 6 of the list item's memFiag field is set to 1. Disabled items appear 

dimmed and cannot be highlighted. 
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enabled Bit 6 of the list item's memFiag field is set to 0. Enabled items appear 

normal and can be highlighted. 

selected Bit 7 of the list item's memFiag field is set to 1, This bit is set when a 

user clicks on the list item, or the item is within a range of selected items. 
A selected item appears highlighted only if it is also enabled. 

highlighted A member of a list appears highlighted only when it is both selected and 
enabled. This means that bit 7 of the memFiag field is set to 1 and bit 6 
is set to 0. A highlighted member is drawn in the highlight colors. 
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Memory Manager 

The following sections correct errors or omissions in Chapter 12, "Memory Manager," in 
Volume 1 of the Toolbox Reference. 



Error correction 

On page 12-10 of the Toolbox Reference, Figure 12-7 shows the low-order bit of the User ID 
is reserved. This is not correa. The figure should show that the maim d field comprises 
bits 0-7, and that the mainiD value of $00 is reserved. 



Clarification 

The Toolbox Reference documentation of the SetHandiesize call ($1902) states "If you 
need more room to lengthen a block, you may compact memory or purge blocks." This is 
misleading. In fact, to satisfy a request the Memory Manager will compact memory or 
purge blocks in order to free sufficient contiguous memory. Therefore, the sentence 
should read "If your request requires more memory than is available, the Memory Manager 
may compact memory or purge blocks, as needed." 
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Menu Manager 

The following sections correct errors or omissions in Chapter 13, "Menu Manager," in 
Volume 1 of the Toolbox Reference. 



Error corrections 

■ In the description of the SetSysBar tool call (pages 13-86 and 13-3), the Toolbox 
Reference states that, after an application issues this call, the new system menu bar 
becomes the current menu bar. This is incorrect. Your application must issue the 
SetMenuBar tool call to make the new menu bar the current menu bar. 

■ In the definition of the menu bar record (pages 13-17-18), the Toolbox Reference shows 
that bits 0-5 of the ctiFiag field are used to indicate the starting position for the 
first title in the menu bar. This is incorrect. ThectiHiiite field defines the starting 
position for the first title. Note further that the entire ctiHiiite field is used in this 
manner. The documented purpose ofthectiHiiite field (number of highlighted 
titles) is not supported by the Menu Bar record. 



Clarifications 

■ The setBarCoiors tool call changes the color table for all menu bars in a window. If 
you want to use separate color tables for different menu bars,, your application must 
build a menu bar color table and modify the cticoior field of the appropriate 
control record to point to this custom color table. See "SetBarColor" in 

Chapter 13, "Menu Manager," of the Toolbox Reference for the format and contents of a 
menu bar color table. 

■ The description of the insertMenu tool call should also note that your application 
must call FixMenuBar before calling orawHenuBar in order to display the modified 
menu bar. 

■ The description of the initPaiette tool call in the Toolbox Reference should also 
note that the call changes color tables 1 through 6 to correspond to the colors needed 
for drawing the Apple logo in its standard colors. 

■ The caicMenuSize call uses the newWidth and newHeight parameters to compute a 
menu's size. These parameters may contain the width and height of the menu, or may 
contain the values $0000 or $FFFF. A value of $0000 tells CaicMenuSize to calculate 
the parameter automatically. A value of $FFFF tells it to calculate the parameter only if 
the current setting is 0. 
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The effect of all three uses: 

□ Pass the new value. The value passed will become the menu's size. Use this 
method when a specific menu size is needed. 

□ Pass $0000. The size value will be automatically computed. This option is useful if 
menu items are added or deleted, rendering the menu's size incorrect. The menu's 
height and width can be automatically adjusted by calling caicMenuSize with 
newWidth and newHeight equal to $0000. 

D Pass $FFFF. The width and height of a menu is when it is created. FixMenuBar 
calls CaicMenuSize with rwwWidth znd newHeight eqml to $FFFF to calculate 
the sizes of those menus with heights and widths of 0. 
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Miscellaneous Tool Set 

The following sections correct errors or omissions in Chapter 14, "Miscellaneous Tool Set," 
in Volume 1 of the Toolbox Reference. 



Error corrections 

■ On page 14-58 of the Toolbox Reference, Figure 14-3 shows the low-order bit of the User 
ID is reserved. This is not correct. The figure should show that the ma in id field 
comprises bits 0-7, and that the mainiD value of $00 is reserved. 

■ The sample code on page 14-28 contains an error. In the code to clear the 1 second IRQ 
source, the second instruction reads 

TSB $C032 

This instruction should read 

TRB $C032 

■ The descriptions of the PackBytes and unPackBytes tool calls in unclear with 
respect to the startHandle parameter to each call. The stack diagrams correctly 
describe the parameter as a pointer to a pointer. However, the C sample code for each 
call defines startHandle 2S a handle. In both cases, startHandle is not a Memory 
Manager handle, but is a pointer to a pointer, Creating startHandle as a handle will 
cause unpredictable system behavior. 
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Print Manager 

The following sections correct errors or omissions in Chapter 15, "Print Manager," in 
Volume 1 of the Toolbox Reference. 



Error corrections 

This section documents errors in the Toolbox Reference. 

u The diagram for the job subrecord, figure 15-10 on page 15-14 of the Toolbox Reference, 
shows that the fFromUsr field is a word. This is incorrect. The f FromUsr field is 
actually a byte. Note that the offsets for all fields following this one are incorrect, as a 
result. This error is also reflected in the tool set summary at the end of the chapter. 

■ The description of the Pr jobDiaiog tool call states that "The initial settings 

displayed in the dialog box are taken from the printer driver . . .." This is incorrect. The 
sentence should begin "The initial settings displayed in the dialog box are taken from 
the print record . . .." 



Clarifications 

■ The existing Toolbox Reference documentaiion for the PrPicFiie tool call does not 
mention that your program may pass a NIL value for statusRecPtr. Passing a NIL pointer 
causes the system to allocate and manage the status record internally. 

■ The PrPixeiMap Call (documented in Volume 1 of the Toolbox Reference) provides an 
easy way to print a bitmap. It does much of the required processing, and an 
application need not make the calls normally required to start and end the print loop. 
The srcLocPtr parameter must be a pointer to a loclnfo record (see Figure 16-3 in 
Chapter 16, "(QuickDraw E," in the Toolbox Reference for the layout of the loclnfo 
record). 
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QuickDraw n 

The following sections correct errors or omissions in Chapter l6, "QuickDraw II," in 
Volume 2 of the Toolbox Reference. 



Error corrections 

The following items provide corrections to the documentation for QuickDraw II in the 
Apple IIGS Toolbox Reference: 

u The documentation in the Toolbox Reference that explains pen modes is somewhat 
misleading. There are, in fact, 8 drawing modes, and you may set the pen to draw lines 
and other elements of graphics in any of these modes. There are also l6 modes used for 
drawing text, and they are completely independent of the graphic pen modes. The 8 
drawing modes listed in Table 16-9 on page 16-235 are valid modes for either the text 
pen or the graphics pen. You can set either pen to any of these modes by using the 
appropriate calls. You can also set the text pen to 8 other modes. These modes are 
listed in the table on page 16-260 of the Toolbox Reference. The setPenMode call sets 
the mode used by the graphics pen; the setTextMode call sets the mode used by the 
text pen. Setting either one does not affect the other. 

■ There are two versions of the Apple IlGS standard 640-mode color tables, one on page 
16-36 and one on page 16-159. The two tables are different; Table 16-7 on page 16-159 
is correct. 

■ In the QuickDraw n chapter, the Apple IlGS Toolbox Reference states that the 
coordinates passed to the LineTo and movsTo calls should be expressed as global 
coordinates. In fact, the coordinates must be local coordinates, and must refer to the 
GrafPort in which the drawing or moving takes place. 



Appendbc F Delta Guide F-15 



Apple IIGS Toolbox Reference, Volume 3 



Beta Draft 



30 August 1989 



Sound Tool Set 

The following sections correct errors or omissions in Chapter 20, "Sound Tool Set," in 
Volume 2 of the Toolbox Reference. 



Error corrections 

This section provides corrections to the documentation of the Sound Tool Set in the 
Apple IIGS Toolbox Reference. 

m The documentation of the FFSoundDoneStatus call includes an error. You will note 
that the paragraph that describes the call does not agree with the "Stack after call" 
diagram. The text states that the call returns TRUE if the specified sound is still 
playing, whereas the diagram states that it returns FALSE if still playing. The diagram, 
not the text, is correct. 

■ There is an undocumented distinction between a generator that is playing a sound and 
one that is active. A generator that is playing a sound returns FALSE in response to an 
FFSoundDoneStatus call. One that is active may or may not be playing a sound; the 
value of the flag returned by FFSoundstatus is TRUE. Active generators are those 
that are allocated to a voice. At any given moment the generator may be playing a 
sound, and so the FFSoundDoneStatus retums FALSE— or it may be silent between 
notes, in which case FFSoundDoneStatus returns TRUE. 



Clarification 

This section presents more complete information about the FFStartsound tool call, 
including further explanation of its parameters, a new error code, an example procedure 
for moving a sound from the Macintosh to the Apple IIGS and some sample code 
demonstrating the use of the call. The original documentation for this call is in 
Chapter 20, "Sound Tool Set," in Volume 2 of the Toolbox Reference. 
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FFS tart Sound 

The freeform synthsizer is designed to play back long wave forms. In order to handle 
longer waveforms the synthesizer uses two buffers (which must be the same size), 
alternating its input from one to the other. When the synthesizer exhausts a buffer, it 
generates an intermpt and then starts reading data from the other buffer. The Sound Tool 
Set services the interrupt and begins refilling the empty buffer. This process continues 
until the waveform has been completely played. 

Note that all synthesizer input buffers must be buffer-size aligned. That is, if you have 
allocated 4K buffers, then those buffers must be aligned on 4K memory boundaries. 

Parameter Block 



$00 


— waveStart 




Long 


$04 


— waveSlze 




Word 


$06 


— freqOffset 




Word 


$08 


— docBuffer — 


Word 


$0A 


— bufferSlze 




Word 


$0C 


— nextWavePtr — 


Long 


$10 


— volSettlng 




Word 



waveStart The Starting address of the wave to be played, not in DOC RAM but in 
Apple IIGS system RAM. The Sound Tool Set loads the waveform data 
into DOC RAM as it is played. 

wavesize The size in pages of the wave to be played. A value of 1 indicates that 
the wave is one page (256 bytes) in size; a value of 2 indicates that it 
is two pages (512 bytes) in size— and so on as you might expect. The 
only anomaly is that a value of specifies that the wave is 65,536 
pages in size. 
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f reqof f set This parameter is copied directly into the Frequency High and 

Frequency Low registers of the DOC. See the previous discussion of 
those registers for more complete information. 

docBuf f er Contains the address in Sound RAM where buffers are to be allocated. 

This value is written to the DOC WaveForm Table Pointer register. The 
low-order byte is not used, and should always be set to 0. 

buf f ersize The lowest three bits set the values for the table-size and resolution 
portions of the DOC Bank-SelectA'able-size/Resolution register. See 
the previous discussion of that register for details. 

nextwavePtr This is the address of the next waveform to be played. If the field's 
value is 0, then the current waveform is the last waveform to be 
played. 

voisetting The low byte of the voisetting field is copied directly into the 
Volume register of the DOC. All possible byte values are valid. 

New error code 



$0817 iRQNotAssignedErr No master IRQ was assigned. 
Moving a sound from the Macintosh to the Apple IIGS 

To move a digitized sound from the Macintosh to the Apple IlGS and play the sound, you 
will have to perform the following steps 

1. Save the sound as a pure data file on the Macintosh. 

2. Transfer the file to the Apple IlGS (using Apple File Exchange, for example). 

3. Filter all the zero sample bytes out of the file by replacing them with bytes set to $01. 
This is very important, because the Apple IlGS interprets zero bytes as the end of a 
sample. 

4. Load the sound into memory with GS/OS calls. 

5. Play the sound with the FFStartsound tool call. 

Set the f reqOf f set parameter to $01B7 in order to play the sound at the same 
tempo as the Macintosh. 
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Sample code 

This assembly-language code sample demonstrates the use of the FFStartsound tool 
call. 



PushWord chanGenType 
PushLong #STParamBlk 
FFStartsound 



set generator for FFSynth 
address of parm block 
start free-from synth 



ChanGenType DC.W $0201 



; generator 2, FFSynth 



STParamBlk DS.L 1 



WaveSize 

Freq 

Start 

Size 

Nxtwave 

Vol 



Entry 
DS.W 1 

DC.W $200 
DC.W $8000 
DC.W $6 
DC.L $0 
DC.W $FF 



WaveSize 



store the address of the 
sound in system memory here 

store the number of pages to 

play here 
A9 set for each sample once 
start at beginning 
16k buffers 
no new parara block 
maximum volume 
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Window Manager 

The following sections correct errors or omissions in Chapter 25, "Window Manager," in 
Volume 2 of the Toolbox Reference. 



Error corrections 

This section corrects some errors in the Window Manager documentation in the Apple IIGS 
Toolbox Reference. 

u The manual's description of SetzoomRect is incorrect. The correct description is as 
follows: 

Sets the f zoomed bit of the window's wFrame record to 0. The rectangle passed to 
SetzoomRect then becomes the window's zoom rectangle. The window's size and 
position when SetzoomRect is called becomes the window's unzoomed size and 
position, regardless of what the unzoomed characteristics were before SetzoomRect 
was called. 

■ Apple IIGS Toolbox Reference page 25-126, third line: 

If wmTaskMask bittmlnfo (bit 15) " 1 

should read: 

If wmTaskMask bittmlnfo (bit 15) " 

■ When used with a window that does not have scroll bars, the call windNewRes calls the 
window's defProc to recompute window regions. A call to sizewindow is not 
necessary under these circumstances. 
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ACIA: See Asynchronous Communications 
Interface Adapter. 

Adaptive Differential Pulse Code Modulation 
(ADPCM): An algorithm for digitizing audio 
samples. Used in the Apple IIGS Audio 
Compression and Expansion Tool Set for 
compressing audio samples. 

ADPCM: See Adaptive Diflferential Pulse Code 
Modulation. 

ADSR: Acronym for attack, decay, sustain, 
release. These terms describe the paradigm for 
representing sounds in terms of a sound 
envelope. 

alert window: Similar to a modal dialog box; 
used to present urgent or important information 
to the user. You create alert windows with the 
Aiertwindow Window Manager tool call. 

Asynchronous Commxmications Interface 
Adapter (ACIA): Adapter card that allows the 
Apple IIGS to support asynchronous 
communications protocols with external 
devices. 

attack: That portion of a sound envelope where 
the sound is increasing from silence to its peak 
loudness. See also ADSR. 

control template: Structure containing the 
information necessary for the NewControi2 
Control Manager tool call to create a new 
control. 

decay: That portion of a sound envelope where 
the sound falls off from its peak loudness to a 
sustained level. See also ADSR. 

Digital Oscillator Chip (DOC): Integrated 
circuit that supports the sound apabilities of 
the Apple IIGS. 

DOC: See Digital Oscillator Chip. 

drop sample tuning: Describes a technique for 
changing the pitch of a played sound that relies 
on skipping (or dropping) sound samples on 



playback. By dropping samples at a fixed rate, 
the pitch of a sound can be raised in octave 
increments. 

envelope: A graphical representation of a 
sound's loudness over time. The envelope 
typically consists of segments identified as 
attack, decay, sustain and release, or ADSR. 

extended controls: Controls created with the 
NewControi2 Control Manager tool call, rather 
than the Newcontroi call. Extended controls 
have new-style control records that contain 
more information than those created by 
NewControl. 

keystroke equivalent: A keystroke that 
activates a control just as if the user had clicked 
in the control. 

menu template: Data structure used to define 
menus, menu items, and menu bars to the Menu 
Manager. 

MIDI: See Musical Instrument Digital 
Interface. 

Musical Instrument Digital Interface 
(MIDI): An interface specification that allows 
external devices to control electronic musical 
instruments. 

out-of-memory queue: A queue maintained by 
the Memorjf Manager. Queue elements (out-of- 
memory routines) refer to code to be 
executed when the Memory Manager detects an 
out-of-memory condition. 

out-of-memory routines: Code executed by 
the Memory Manager when it detects an out-of- 
memory condition. The out-of-memory queue 
consists of a list of these routines. 

password field: Do not echo user input, 
allowing protected data entry. Your program can 
specify the echo character; the default echo 
character is asterisk (*). 

pop-up menu: A menu that "pops" out of its 
display rectangle when selected by the user. The 
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two types of pop-up menus, type 1 and type 2 
pop-up menus, have different limits on their 
maximum size. 

feference type: Indicates whether a storage 
location contains a pointer, a handle, or a 
resource ID for an object. 

release: That portion of a sound envelope 
where the note dies away to silence. See also 
ADSR. 

resource: Collection of data managed by the 
Resource Manager for other applications. 

resource file: A collection of one or more 
resources. The Resource Manager provides 
routines for accessing and updating resources in 
a resource file. 

resource ID: Uniquely identifies a resource 
within the context of its resource type. The 
Resource Manager provides facilities to assign 
unique resource IDs. Compare resource name. 

resource name: Uniquely identifies a resource 
within the context of its resource type. Note 
that resource names are not maintained by the 
system; it is your program's responsibility to 
assign and manage them. Compare resource ID. 

resource type: Identifies a class of resources 
that share a common data layout. Individual 
instances of resources of a given type are 
identified by their unique resource ID or 
resource name. 

run item: An element in the run queue. Run 

items specify program code to be executed by 
the Desk Manager at regular intervals. 

run queue: A queue maintained by the Desk 
Manager that contains elements (run items) 
that specify code to be executed at regular 
intervals. 

sample rate: Specifies the number of sound 
samples the Apple IlGS DOC plays per second. 



sustain: That portion of a sound envelope 
where the note maintains a fairly constant 
loudness, before it dies away. See also ADSR. 

target control: That control which is currently 
the recepient of user actions (keystrokes and 
menu items). 

TextEdit record: Describes a TextEdit user 
session, whether or not that session is managed 
as a control. 

type 1 pop-up menu: A pop-up menu that will 
not grow beyond its window constraints. 
Compare type 2 pop-up menu. 

type 2 pop-up menu: A pop-up menu that will 
grow beyond its window if necessary to display 
its menu items. Compare type 1 pop-up menu. 
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A/D converter register 
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ACEExpand 27- 15 
ACEExpBegin 27- 17 
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ACEReset27-9 
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ACEStartUp 27- 6 
ACEStatus 27- 10 
ACEVersicxi 27- 8 
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adding items to a menu 37- 23 
AddResource 45- 34 
AddToOOMQueue 36- 8 
AddToQueue 39- 3, 5 
AddToRunQ 29- 6 
ADPCM See Adaptive Differential 

Pulse Code Modulation 
alert windows 

buttrai strings 52- 8 

example 52- 10 

icon number 52- 7 

message text 52- 8 

separator character 52- 8 

size characters 52- 6 

special charaaers 52- 9 

terminator character 52- 8 
alert windows 52- 5-11 
alert windows E- 2 
AlertWindow 52- 22 
AllNotesOff41-20 
allocating TextEdit records 49- 104 
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AppleShare and Standard File 48- 3 
AppleTalk print zone 42- 14 
AppleTalk, MIDI Tool Set and 38- 22 



application switchers 

and Resource Manager 45- 26, 41, 
66 

attack 41- 3 

attack, decay, sustain, release 41- 2 
auto-key events, limit on 31- 6 
aWaveCount, Note Synthesizer 
parameter 41- 9 



bank selea bit 

Sound Tool Set and 47- 16 
bank-select/table-size/resolution 
register 
Sound Tool Set and 47- 14 
boundary rectangle 

automatically computed for 

some controls 28- 3 
automatically computed for 

some controls F- 5 
control definition procedures 28- 
16 

bounds, control definition 

procedure routine 28- 16 

breakpoints and inaements in 
sound envelopes 41- 4 

button strings, in alert windows 52- 8 

bWaveCount, Note Synthesizer 
parameter 41- 9 

C 

C strings, as resources E- 45 

caching custom menus 37- 7 

caching menus 37- 6 

CalcMask43-3 

CallCtlDefProc 28- 21 

CallRoutine command. Note 
Sequencer 40- 11 

changing window size, and controls 
52-4 

channel register 

Sound Tool Set and 47- 14 

check box control 
control template 28- 51 
extended control record 28- 98 



new features 28-7 
check box control template E- 13 
ChooseFont bugfix 32- 2 
choosing printers 42- 3 
classic desk accessories 29- 2, 8 
ClearHeartBeat 39- 2 
Qearlna 40- 45 

clearing TextEdit selection 49- 75 
QoseResourceFile 45- 36 
CMLoadResource 28- 23 
CMReleaseResource 28- 24 
color behavior and even pixel 

alignment 28- 3 
color behavior and even pixel 

alignment F- 5 
color tables 

640 mode 43- 2 

640 mode F- 15 

menu bars 37- 2 

menu bars F- 11 

now use 4 bits for 640 mode 28- 4 
size box control 28- 2 
size box control F- 4 
command interpreter, Note 

Sequencer 40- 5 
common style record, TextEdit 49- 
88 

CompileText 52- 24 
completion routines, Note 

Sequencer 40- 6, 54, 56 
compressing TextEdit records 49- 78 
compression ratios, in ACE Tool Set 

27-2 

compression, digital audio 27- 2 
control commands. Note Sequencer 
40- 10 

control definition procedures 
bounds routine 28- 16 
drag routine 28- 13 
drawing in 28- 13 
event routine 28- 14 
initialize routine 28-13 
new messages 28- 12 
notify multipart routine 28- 19 
record size routine 28- 13 
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sending messages to 28- 35 

Ub routine 28- 18 

target routine 28- 15 

window diange routine 28- 20 

window size routine 28-17 
Control Manager 

new controls 28- 6 
control register 

Sound Tool Set and 47- 13 
control template, check box E- 13 
control template, icon button E- 15 
control template, LineEdit E- 18 
control template, list E- 20 
control template, picture E- 24 
control template, pop-up menu E- 
26 

control template, radio button E- 30 
control template, scroll bar E- 32 
control template, simple button E- 
11 

control template, size box E- 34 
control template, static text E- 36 
control template, TextEdit E- 38 
control templates 

and NewControl2 28- 42 
check box control 28- 51 
icon button control 28- 53 
LineEdit control 28- 56 
list control 28- 58, 6l 
pop-up menu control 28- 63 
radio button control 28- 69 
sample code 28- 83 
saoll bar control 28- 71 
simple button control 28- 49 
size box control 28- 73 
standard header 

fCtlCanBeTarget flag 28- 14, 
46 

fCtlIsMultiPartflag28-19, 
46 

fCtlProcRelNotPtr flag 28- 
46 

fOlTarga flag 28- 46 

fCtlTellAboutSizeflag28- 

46 

fCtlWantEventsflag 28-46 
fCtlWantsEvents flag 28- 14 
Hag field 28- 45 
ID field 28- 44 
morePlags field 28- 46 
pCount field 28- 43 



procRef field 28- 44 
rea field 28- 44 
refCon field 28-47 
standard header 28- 43 
static text control 28- 75 
TextEdit control 28- 77 
control templates 28- 6, 42-88 
controls 

and keystroke processing 28- 4 
aeating 28- 33 
target 28- 5, 18,25,31,32,36 
controls, changes in drawing 28- 2 
controls, changes in drawing F- 4 
copying text, with TextEdit 49- 79 
CountResources 45- 37 
CountTypes 45- 38 
CreateResourceFile 45- 39 
aeating menu bars 37- 25 
aeating menus 37- 24 
creating TextEdit records 49- 104 
aeating windows 52- 32 
ctlChangeBounds control definition 

procedure message 28- 16 
ctlChangeTarget control definition 

procedure message 32 
CtlChangeTarget control definition 
procedure message 28- 15 
ctlHandleEvent control definition 

procedure message 36 
CtlHandleEvent control definition 
procedure message 28- 14 
ctlHandleTab control definition 
procedure message 28- 18 
ctllD Control Manager field 93 
ctllD Control Manager field 28- 26, 
27,38 

ctlMoreFlags Control Manager field 
35,93 

CtlMoreFlags Control Manager field 

28- 28, 39 
ctlNotifyMultiPart control definition 

procedure message 28- 19 
ctlWindChangeSize control 

definition procedure message 

28-17 

ctlWinStateChange control definition 

procedure message 28- 20 
current resource file, finding 45- 42 
cursorOfFset, TERecord KeyRecord 

field 49- 23 
custom menus and caching 37- 7 
cutting text, with TextEdit 49- 80 
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data struaures, TextEdit 49- 29 
deaaivating TextEdit records 49- 81 
dead key translation 31- 4 
deallocating TextEdit records 49- 103 
DeAllocGen 41- 22 
Dec Register command. Note 

Sequencer 40-17 
decay 41- 3 

defProcs See control definition 

procedures 
DeleteFromQueue 39- 6 
DeleteHeartBeat 39- 2 
deleting text, with TextEdit 49- 80 
desk accessories 

and Resource Manager 45- 26, 41, 
66 

desk accessories, and Control 

Manager 28- 29 
desk accessories, and TaskMaster 52- 

4,39 

DetachResource 45- 40 

dialog templates. Standard File 48- 12 

displaying error messages 52- 29 

displaying menu bar 37- 32 

DOC memory 41- 10 

DOC mode 

Sound Tool Set and 47- 13 
DOC registers 

reading values 47- 21 

setting values 47- 23 

Sound Tool Set and 47- 11, 21, 23 
doEraseBuffer, TextEdit filter 

procedure routine 49- 18 
doEraseRect, TextEdit filter 

procedure routine 49- 17 
doReaChanged, TextEdit filter 

procedure routine 49- 19 
draft mode, printing 42- 3 
drag, control definition procedure 

routine 28- 13 
DrawInfoBar 52- 27 
drawing controls, changes in 28- 2 
drawing controls, changes in F- 4 
DrawMember2 35- 5 
drop sample tuning 

Sound Tool Set and 47- 10 

E 

empty menus, aeating 37- 4 
enabled, list items 35- 2 
enabled, list items F- 9 
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EndFrameDrawing 52- 28 
envelopes (sound) See sound 

envelopes 
error handlers, Note Sequencer 40- 

6,54,56 
error message text 52- 44 
error messages, displaying 52- 29 
error processing, with TextEdit 49- 84 
ErrorWindow 52- 29 
event, control definition procedure 

routine 28- 14 
extended control records 
check box control 28- 98 
icon button control 28- 101 
lineEdit control 28- 104 
list control 28- 107 
picture control 28- 110 
pop-up menu control 28- 113 
radio button control 28- 118 
SCToll bar control 28- 121 
simple button control 28- 95 
size box control 28- 124 
standard control record 
ctlAaion field 28- 92 
cdColorfield28-93 
ctlDatafield28-92 
caFlagfield28-91 
ctlHilitefield28-91 
ctlIDfield28-93 
ctlMoreFlags field 28- 93 
ctlNextfield28-91 
ctlOwner field 28- 91 
caProcfield28-92 
ctlRectfield28-91 
ctlRefCon field 28- 92 
ctlReservedfield28-93 
ctlVaIuefield28-91 
diversion field 28- 94 
fCtlCanBeTargetflag28-93 
fCtlIsMultiPaitfiag28-94 
fCtlProcRefNotPtrflag28- 
94 

fQlTarget{lag28-15,25,31, 
93 

fCUTellAboutSi2eflag28- 
94 

fiCtlWantEventsfiag28-93 
standard control record 28- 89 
static text conu-ol 28- 127 
TextEdit control 28- 131 



extended control records 28- 89-142 
extended controls 28- 7 
extended controls 28- 33, 89 

F 

FASTFONT 43- 3 

flFromUser Print Manager parameter 

42- 2 

fPromUser Print Manager parameter 
F- 14 

FFSetUpSound 47- 18 
FFSoundDoneStatus 47- 2 
FFSoundDoneStatus F- 16 
FFStartPlaying 47- 20 
FFStartSound 47- 3 
FFStartSound F- 17 
fidelity, in ADPCM compression 27- 4 
file name separator characters 48- 3 
file prefixes 48- 2 

file type list record. Standard File 48- 
9 

Filler note command. Note 

Sequencer 40- 8 
filler notes, Note Sequencer 40- 8 
filling a saeen region with a pattern 

43- 3.8 

filter procedures in Standard File 48- 
4 

filter procedures, TextEdit See 

TextEdit: filter procedures 49- 
filtering keystrokes, in TextEdit 49- 20 
filterProc, TERecord field 49- 16, 53 
filterProcPtr, TEParamBlock field 49- 
16 

filterProcPtr, TEParamBlock record 

field 49- 43 
FindTargetQl 28- 25 
FMStartUp changes 32- 2 
font header layout 43- 5 
free memory 36- 9 
freeform synthesizer 47- 3, 18, 20 
freeform synthesizer F- 17 
fi'eeing space in TextEdit records 49- 

78 

frequency 

Sound Tool Set and 47- 11 
frequency registers 

Sound Tool Set and 47- 12 

G 

GCB See generator control block 

(GCB) 
GDRPrivate 52- 43 



generator control block (GCB) 41- 11 
generators 

active and inactive 47- 2 

active and inactive F- 16 

allocating 41- 21 

deallocattag 41- 22 

Sound Tool Set and 47- 9 
generators, Note Synthesizer 41-10 
GetCodeResConverter 39- 7 
GetCtlHandleFromID 28- 26 
GaCtllD 28- 27 
GetCtlMoreFlags 28- 28 
GetCtlParamPtr 28- 29 
GetCurResourceApp 45- 41 
GetCurResourceFile 45- 42 
GetlndResource 45- 43 
GetlndType 45- 45 
GetlntemjptState 39- 8 
GetlntStateRecSize 39- 9 
GetKeyTranslation 31- 5 
GetLEDefProc 34- 5 
GetLoc 40- 46 
GetMapHandle 45- 46 
GetOpenFileRefNum 45- 48 
GetPopUpDefl'roc 37-21 
GetResourceAttr 45- 9, 50 
GetResourceSize 45- 51 
GetROMResource 39- 9 
GetTimer 40- 47 
GetVector 39- 2 
GetWindowMgrGlobals 52- 31 
GS/OS Class 1 input strings, as 

resources Er 43 
GS/OS Qass 1 output strings, as 
resources E- 44 

H 

heartbeat task 39- 2 
HideMenuBar 37-22 
hiding the menu bar 37- 22 
highlighted, list items 35- 3 
highlighted, list items F- 9 
HomeResourceFile 45- 52 
hook routines, TextEdit See TextEdit: 

hook routines 49- 
horizontal scrolling, and TaskMaster 

52-3 

I 

icon button control 

control record 28- 101 

control template 28- 53 
icon button control 28- 6, 7 
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icon number, in alert windows 52- 7 
icons, as resources E- 46 
IfGo Register command. Note 

Sequencer 40- 17 
inactive, list items 35- 2 
inaaive, list items F- 8 
Inc Register command, Note 

Sequencer 40- 18 
initialize, control definition 

procedure routine 28-13 
inserting text, with TextEdit 49- 99 
InsertMItem2 37-23 
InstallWithStats32-3 
instrument table 

setting 40- 50 
instrument table 40- 50 
instruments 

assigning to tracks 40- 51 

Note Synthesizer 41- 6 
instruments 40- 50 
interrupt enable bit 

Sound Tool Set and 47- 13 
interrupt state information 

getting 39- 8 

getting size of 39-9 

setting 39- 11 
interrupt state information 39- 4 
interrupts, handling sound 47- 6 
interrupts, MIDI Tool Set and 38- 22 
intenupts, MIDI, Sound Tool Set and 

47-17 
InvalCtls28-30 

item drawing routines in Standard 

File 48- 5 
item name, menu, setting 37- 30, 31 
item numbers for lists 35- 4, 5, 8, 9, 10 

J 

job subrecord 42- 2 
job subrecord F- 14 
joumaling and ReadMouse 31- 2 
joumaling and ReadMouse 39- 10 
Jump command. Note Sequencer 
40-12 

justification (text) in pictures 44- 2 
justification, TextEdit 49- 3 

K 

keyboard equivalent 37- 6 
keyboard input translatton 31- 3, 5, 7 
keyboard interface, TextEdit 49- 11 
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keyboard, polling for status of keys 
26-3 

keyboard, polling for status of keys F- 
3 

keyFilter, TERecord field 49- 20, 58 
KeyRecord, TextEdit record layout 
49-59 

keystroke equivalent 37- 6 
keystroke equivalent E- 10 
keystroke equivalents 28- 4, 48 
keystroke equivalents 37- 8 
keystroke equivalents in Standard 

File dialogs 48- 4 
keystroke processing in controls 28- 4 
keystrdce translation 31- 3, 5, 7 
keystroke translation E- 47 
keystroke translation tables, as 

resources E- 47 
killing TextEdit records 49- 103 

L 

LineEdit control 

control record 28- 104 

control template 28- 56 
LineEdit control 28- 6, 8 
LineEdit control template E- 18 
LineEdit record, new layout 34- 2 
list control 

control record 28- 107 

control template 28- 58, 6l 
list control 28- 6, 9 
list control template E- 20 
list controls and saoll bars 35- 4 
list item numbers 35- 4, 5, 8, 9, 10 
List Manager and Print Manager 42- 3 
List Manager definitions 35- 2 
List Manager definitions F- 8 
LoadAbsResource 45- 53 
loading tool sets, and version 

numbers 51- 2 
LoadResource 45- 55 
long sequences, compressing 27- 12, 
17 

Long2Dec Integer Math tool call 33- 2 
Long2Dec Integer Math tool call F- 7 

M 

MakeNextCtlTarget 28- 31 
MakeThisCtlTarget 28- 32 
MarkResourceChange 45- 57 
MatchResourceHandle 45- 58 
memory, DOC 41- 10 
memory, free 36- 9 
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menu bar 

aeating 37- 25 

hiding 37- 22 
menu bar template 37- 20 
menu bar template, as resource E- 
53 

menu bar, displaying 37- 32 
menu caching 37- 6 
menu item template 37- 15 
menu item template, as resource E- 
54 

menu item, naming 37- 30, 31 

menu record, changes 37- 6 

menu template 37- 18 

menu template, as resource E- 50 

menu title, setting 37- 29 

menus 

adding items 37- 23 

aeating 37- 24 
menus, custom, and caching 37- 7 
menus, saolling 37- 5 
message center 51- 14 
message text, in alert windows 52- 8 
MessageByName 51- 14 
MIDI dock 

operation 38- 6 

reading current frequency 38- 48 

reading cunent value 38- 48 

setting base value 38- 33 

setting frequency 38- 35 

starting 38- 34 

stopping 38- 34 
MIDI dock 38- 23, 33 
MIDI commands, Note Sequencer 

40- 19 
MIDI data 

ignoring System Exclusive data 
38-42 

packet format 38- 7 

raw data mode 38- 8 

reading 38- 49 

sending and receiving 38- 6, 24, 
37-42, 46-47 

writing 38- 51 
MIDI data input, starting 38- 38 
MIDI data input, stopping 38- 39 
MIDI data mode, setting 38- 40, 41 
MIDI data output, starting 38- 39 
MIDI data output, stopping 38- 39 
MIDI enor vector, sating 38- 37 
MIDI input buffer, setting 38- 37 
MIDI output buffer, setting 38- 38 
MIDI real-time command vector, 
setting 38- 36 
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MIDI System Exclusive data 38- 42 
MIDI time-stamps 

setting base value 38- 33 
setting frequency 38- 35 
starting 38- 34 
stopping 38- 34 
MIDI time-stamps 38- 6, 23 
MIDI Tool Set 
AppleTalk 38- 22 
fast access to tool calls 38- 20 
interrupts 38- 22 
loading and unloading device 

drivers 38- 43 
service routines 

input data routine 38- 9, 12 
output data routine 38- 9, 
13 

real-time command 
routine 38- 9, 10, 36 
real-time error routine 38- 

9,11,37 
service routines 38- 9 
shutting down 38- 28 
starting 

sample code 38- 14 
starting 38- 6, 27 
tool dependencies 38- 7, 23 
MIDI, Note Sequencer and 40- 4 
MidiBootlnit 38- 26 
MidiChannelPressure command, 

Note Sequencer 40- 20 
MidiClock 38- 33 
MidiControl 38- 36 

MidiControlChange command, Note 

Sequencer 40- 20 
MidDevice 38- 43 
Midilnfo 38- 46 
MidiNoteOff command. Note 

Sequencer 40- 20 
MidiNoteOn command. Note 

Sequencer 40- 21 
MidiPitchBend command. Note 

Sequencer 40- 21 
MidiPolyphonicKeyPressure 

command. Note Sequencer 

40- 22 

MidiProgramChange command. 

Note Sequencer 40- 22 
MidiReadPacket 38- 49 
MidiReset 38- 30 

MidiSelectChannelMode command, 
Note Sequencer 40- 22 



MidiSetSysExlHighWord command. 

Note Sequencer 40- 23 
MidiShutDown 38- 28 
MidiStartUp 38- 27 
MidiStatus 38- 31 

MidiSystemCommon command, 

Note Sequencer 40- 24 
MidiSystemExclusive command. 

Note Sequencer 40- 23 
MidiSystemRealTime command. 

Note Sequencer 40- 25 
MidiVersion 38- 29 
MidiWritePacket 38- 51 
moreFlags, TEParamBlock record 

field 49- 40 
mouse interface, TextEdit 49- 11 
mouse, tracking in TextEdit records 

49-76 

multifile reply record. Standard File 
48-8 

multipart controls, control definition 
procedure routines 28- 19 

Musical Instrument Digital Interface 
(MIDI) 38- 2 

N 

naming print documents 42- 3, 6, 9 
network printer, getting information 

about 42- 10 
new desk accessories 29- 2, 9 
NewControl2 28- 33 
NewList2 35-6 
NewMenu2 37- 24 
NewMenuBar2 37-25 
NewWindow2 52- 32 
NextMember2 35- 8 
note commands. Note Sequencer 

40-7 
Note Sequencer 

command interpreter 40- 5 

initializing 40- 38 

intemjpt mode 40- 39 

tod dependencies 40- 3 

update rate 40- 39 
Note Sequencer commands 

control commands 40- 10 

MIDI commands 40- 19 

note commands 40- 7 

register commands 40-16 
note sequences 

controlling tempo 40- 49 

getting information about 40- 46 

playing 40- 60 



starting 40- 53, 55 

stopping 40- 62 

stopping and starting 40- 45 

timing 40- 3 

turning off notes 40- 48 
note sequences 40- 26 
Note Synthesizer 

setting update rate 41- 15, 26 

sound envelopes 41-4 

starting 41- 15 

starting and using 41-2 

tool dependencies 41- 2 
Note Synthesizer instruments 41- 6 
NoteO£F41- 2, 23 

NoteOff command. Note Sequencer 

40-9 
NoteOn41-2,24 

NoteOn command, Note Sequencer 

40- 9 

notes 

turning off4l- 20, 23 

turning on 41- 24 
notes off, turning Note Sequencer 40- 
15 

notify multipart, control definition 

procedure routine 28- 19 
NotifyQls28-35 
NSBootlnit 41- 14 
NSReset 41- 18 
NSSetUpdateRate 41- 26 
NSSetUserUpdateRm 41- 27 
NSShutDown 41-16 
NSStartUp 41- 15 
NSStatus41- 19 
NSVersion 41- 17 

O 

OpenResourceFile 45- 60 
oscillator enable register 

Sound Tool Set and 47- 16 
oscillator interrupt register 

Sound Tool Set and 47- 16 
oscillators 

Sound Tool Set and 47- 9 
oscillators, used to form generators 

41- 10 

out-of-memory queue 36- 2 
out-of-memory routines 36- 2, 8, 10 
out-of-memory routines, and 
TextEdit 49- 78 

P 

PackBytes 39- 2 
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PackBytes F- 13 

page orientation, getting information 

about 42- 7 
Pascal strings, as resource E- 56 
password fields 34- 2 
pasting text with TextEdit 49- 110 
pattern filling 43- 3, 8 
patterns (drawing) 
640 mode 43- 3 
patterns. Note Sequencer 40- 26 
phrase done flag 40- 26 
phrases, Note Sequencer 40- 26 
picture control 

control record 28- 110 
picture control 28- 6, 9 
picture control template E- 24 
Pitch Bend command, Note 

Sequencer 40- 13 
pitchbend. Note Synthesizer 

parameter 41- 12 
pitchbendRange, Note Synthesizer 

parameter 41- 8 
PMLoadDriver 42- 4 
PMStartUp Print Manager call 42- 3 
PMUnloadDriver 42- 5 
pop-up control 28- 10 
pop-up menu control 
control record 28- 113 
control template 28- 63 
pop-up menu control 28- 6 
pop-up menu control template E- 

26 

pop-up menus 

defining and using 37- 12 
with other Menu Manager calls 
37-13 
pop-up menus 37- 8 
PopUpMenuSelect 37-27 
port state and Control Manager tool 

calls 28-3 
port state and Control Manager tool 

calls F- 5 
PostSaipt fonts, printing with 42- 3 
PrChoosePrinter Print Manager call 
42-3 

PrGetDocName 42- 6 
PrGetNetworkName 42- 10 
PrGetPgOrientation 42- 7 
PrGetPortDvrName 42- 11 
PrGetPrinterDvrName 42- 12 
PrGetPrinterSpecs 42- 8 
PrGetUserName 42- 13 
PrGetZoneName 42- 14 
print documents, naming 42- 3, 6, 9 



Print Manager and List Manager 42- 3 
print zone name, getting iiiformation 

about 42- 14 
printer driver, getting information 

about 42- 12 
printer port driver, getting 

infomiation about 42- 11 
printer, getting information about 42- 

8 

printing TextEdit text 49- 108 
prioritylncrement. Note Synthesizer 

parameter 41-8 
PrJobDialog Print Manager call 42- 2 
PrJobDialog Print Manager call F- 14 
Program Change command. Note 

Sequencer 40- 14 
PrPicFile Print Manager call 42- 2 
PrPicFile Print Manager call F- 14 
PrPixelMap Print Manager call 42- 2 
PrPixelMap Print Manager call F- 14 
PrSetDocName 42- 9 

Q 

queues and queue handling 39- 3 
queues, adding entries 39- 5 
queues, deleting entries 39- 6 

R 

radio button control 
control template 28- 69 
extended control record 28-118 
new features 28- 11 
radio button control template E- 30 
rAlertString resource type E- 2 
rClInputString, resource type E- 43 
rClOutputString, resource type E- 44 
rControlList resource type E- 3 
rControlTemplate 

check box control template E- 13 
icon button control template E- 
15 

keystroke equivalent E- 10 
LineEdit control template E- 18 
list control template E- 20 
piaure control template E- 24 
pop-up menu control template 
E- 26 

radio button control template E- 
30 

saoll bar control template E- 32 
simple button control template 
E-11 

size box conurol template E- 34 



standard header E- 5 
static text control template E- 36 
TextEdit control template E- 38 
rControlTemplate resource type E- 4 
rCString, resource type E- 45 
readConfig parameters, in ADB 

ReadKeyMiaoData call 26- 2 
readConfig parameters, in ADB 

ReadKeyMiaoData call F- 2 
ReadDOCReg47-21 
ReadMouse2 39- 10 
RealFreeMem 36- 9 
record size, control definition 

procedure routine 28- 13 
reference types 28- 5 
register commands. Note Sequencer 

40-16 
release 41- 3 
ReleaseResource 45- 62 
ReleaseROMResource 39- 10 
releaseSegment, Note Synthesizer 

parameter 41-7 
RemoveCDA 29- 8 
RemoveFromOOMQueue 36- 10 
RemoveFromQueue 39- 3 
RemoveFromRunQ 29- 7 
RemoveNDA 29- 9 
RemoveResource 45- 63 
removing text, with TextEdit 49- 80 
replacing text with TextEdit 49- 113 
reply record. Standard File 48- 6 
ResetMember2 35- 9 
ResizeWindow 52- 4, 35 
resource attributes 

getting 45- 50 

setting 45- 68 
resource converters 

loading code resources 39- 7 

ReadResource 45- 21 

RetumDiskSize 45- 25 

WriteResource 45- 23 
resource converters 45- 20, 64 
resource files 

adding resources 45- 34 

changing search sequence 45- 13, 
67,69 

aeating 45- 39 

current 45- 36 

current file 45- 12 

current, finding 45- 42 

file ID 45- 60 

file IDs 45- 11 

format and content 45- 11, 13 
free block layout 45- 18 
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getting GS/OS reference number 
for 45- 48 

getting resource map 45- 46 

iieader layout 45- 15 

last file 45- 12 

map layout 45- 16 

opening 45- 60 

reference record layout 45- 19 

search sequence 45- 12 

system 28- 5 

system 45- 8, 36 
resource files 45- 5 
resource free block layout 45- 18 
resource header layout 45- 15 
resource E) 45- 5 
resource IDs 

getting unique 45- 73 

setting 45- 70 
Resource Manager 

getting cun-ent user ID 45- 41 

starting 45- 8 
resource map layout 45- 16 
resource map, getting, for a resource 

file 45- 46 
resource names 45- 7 
resource names, as resource E- 57 
resource reference record layout 45- 
19 

resource search sequence 45- 12 

resource types 
counting 45- 38 
getting by index 45- 45 

resource types 45- 5 

ResourceBootlnit 45- 28 

ResourceConverter 45- 20, 64 

ResourceReset 45- 32 

resources 

adding to resource files 45- 34 
and Control Manager 28- 5 
and Window Manager 52- 32 
and Window Manager E- 68, 72 
attributes of 45- 9 
changing 45- 57, 75 
controlling loading from disk 45- 
71 

copying 45- 40 
counting 45- 37 
defined 45- 2 

deleting from resource file 45- 63 
detaching 45- 40 
finding by handle 45- 58 
finding file for 45- 52 
getting by index 45- 43 
getting size of 45- 51 



Beta Draft 
loading 45- 55 

loading at absolute address 45- 53 
removing from memory 45- 62 
removing from resource file 45- 
63 

using 45- 2,8 

writing to disk 45- 76 
ResourceShutDown 45- 30 
ResourceStartUp 45- 29 
ResourceStatus 45- 33 
ResourceVersion 45- 31 
ricon, resource type E- 46 
rKTiansTable, resource type E- 47 
rListRef, resource type E- 49 
rMenu, resource type E- 50 
rMenuBar, resource type E- 53 
rMenuItem, resource type E- 54 
rPString, resource type E- 56 
rResName, resource type E- 57 
rStringlist, resource type E- 59 
rText, resource type E- 60 
rTextBlock, resource type E- 6l 
rTextBox2, resource type E- 62 
rToolStartup, resource type E- 63 
rTwoRects, resource type E- 65 
run item layout 29- 3 
run queue 

adding run items 29- 6 

example 29- 5 

removing run items 29- 7 
run queue 29- 3 

rWindColor, resource type E- 66 
rWindParaml, resource type E- 68 
rWindParam2, resource type E- 72 

s 

sample code 

application switcher and 

Resource Manager 45- 26 
control templates 28- 83 
creating empty menus 37- 4 
fast access to MIDI Tool Set 

routines 38- 20 
FFStartSound 47- 5 
FFStartSound F- 19 
note sequence with relative 

addressing 40- 58 
Note Sequencer 40- 28 
Note Synthesizer 41- 25 
out-of-memory routines 36- 5 
reading time-stamped MIDI data 

38-16 
run queue 29- 5 
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Standard File dialog templates 48- 
13 

starting the MIDI Tool Set 38- 14 
TaskMasterContent 52- 37 
TaskMasterKey 52- 40 
TextEdit control with TaskMaster 
49-6 

TextEdit control without 
TaskMaster 49- 7 
TextEdit record that is not a 

control 49- 9 
writing time-stamped MIDI data 
38-18 
sample rates 

Sound Tool Set and 47- 10 
saoll bar control 

control template 28- 71 
extended conu-ol record 28-121 
new features 28- 11 
saoll bar control 28- 4 
saoll bar control barArrowBack 

enUy28-3 
saoll bar control barArrowBack 

entry F- 5 
saoll bar control template E- 32 
saoll bars and list controls 35- 4 
saoll bars, in TextEdit 49- 28 
saolling menus 37- 5 
saolling text in TextEdit 49-116 
saolling, horizontal, and TaskMaster 
52-3 

search sequence, resource 45- 12 
SeedFill 43- 8 
seleaed, list items 35- 2 
selected, list items F- 9 
selection, clearing TextEdit 49- 75 
selection, copying with TextEdit 49- 
79 

seleaion, getting information about 

current TextEdit 49- 87 
seleaion, getting information about 

styles in TextEdit 49- 88 
seleaion, setting the current TextEdit 

49- 120 
SelectMember2 35- 10 
SendEventToCtl 28- 36 
separator charaaer, in alert windows 

52-8 

separator charaaers in file names 48- 
3 

SeqAllNotesOfr40-48 
SeqBootlnit 40- 37 
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seqitems (Note Sequencer sequence 
items) See Note Sequencer: 
sequence items 40- 

SeqReset 40- 43 

SeqShutDown 40- 41 

SeqStartUp 40- 38 

SeqStatus40- 44 

sequences (note) See note sequences 
40- 

SeqVersion 40- 42 

Set Register command, Note 

Sequencer 40- 18 
SetAutoKeyLimit 31- 6 
SetCtUD 28- 38 
SetCtlMoreFlags 28- 39 
SetCtiParamPtr 28- 40 
SetCurResourceApp 45- 66 
SetCurResourceFile 45- 13, 67 
SetDefauitTPT51- 17 
SetIX)CReg47-23 
Setlna 40- 49 

SetlnputDevice tool call 50- 2 

SetlnstTable 40- 50 

SetlntermptState 39- 11 

SetKeyTranslation 31- 7 

SetMenuTitle2 37-29 

SetMItera2 37-30 

SetMItemName2 37- 31 

SetOriginalMask 52- 3 

SetOutputDevice tool call 50- 2 

SetResourceAttr45-9, 68 

SetResourceFileDepth 45- 13, 69 

SetResourcelD 45- 70 

SetResourceLoad 45- 71 

SetTrklnfo40- 51 

SetUserSoundlRQV 47- 6 

SetVector 39- 2 

SetZoomRect 52- 2 

SetZoomRect F- 20 

SFAUCaps 48- 27 

SFGetFlle2 48- 28 

SFMultGet2 48- 30 

SFPGetFile2 48- 32 

SFPMultiGet2 48- 34 

SFPPutFile2 48- 36 

SFPutFile2 48- 39 

SFReScan 48- 41 

SFShowInvisible 48- 42 

ShowMenuBar 37-32 

ShutDownTools 51- 2, 18 

simple button control 
control template 28- 49 
extended control record 28- 95 
new features 28-7 



simple button control template E- 1 1 
size box control 

control template 28- 73 
extended control record 28- 124 
new features 28- 11 
size box control color table 28- 2 
size box control color table F- 4 
size box control template E- 34 
size characters, in alert windows 52- 6 
SizeWindow 52- 4 
Slot Arbiter 50- 2 

smart cut and paste, TextEdit 49- 3 
SortList2 35-ll 
sound envelopes 

attack, decay, sustain, release 41- 2 

breakpoints and inaements 41- 4 

data structures 41- 7 

duration of 41- 5 

Note Synthesizer 41- 4 
sound envelopes 41- 2 
sound on the Ilgs, introduction to 
47-7 

sound tools, version requirements 
47-6 

sounds, playing 47- 20 
sounds, preparing to play 47- 18 
special charaaers, in alert window 

alert strings 52- 9 
SpecialRect 43- 15 
Standard File limits 48- 2 
StartPrameDrawing 52- 36 
starting and stopping tool sets 51- 2, 

4, 18, 19 
starting tool sets 51- 19 
Startlnts 40- 52 
StartSeq40- 53 
StartSeqRel 40- 55 
StartStop record, as resource E- 63 
StartStop record, starting and 

stopping tool sets 51- 4 
StartUpTools 51- 2, 19 
static text control 

control record 28- 127 
control template 28- 75 
static text control 28- 6, 11 
static text control template E- 36 
StepSeq40- 60 
Stoplnts 40- 61 
stopping tool sets 51- 18 
StopSeq 40- 62 

Styleltem, TextEdit record layout 49- 
62 

styles, changing TextEdit 49- 124 



subsequences, in compression 27- 
12, 17 

SuperBlock, TextEdit record layout 
49-63 

SuperHandle, TextEdit record layout 
49-64 

Superltem, TextEdit record layout 

49-65 
sustain41- 3 

synthesizer voices 47- 9 
system resource file 28- 5 

T 

tab, control defmition procedure 

routine 28- 18 
Tabltem, TextEdit record layout 49- 

66 

target control 28- 5, 18, 25, 31, 32, 36 

target controls 49- 2, 74, 81 

target, control definition procedure 

routine 28- 15 
task record, new defmition 52- 17 
TaskMaster52-17, 37, 39, 40 
TaskMaster result codes 52- 12 
TaskMasterContent 52- 37 
TaskMasterDA 52- 39 
TaskMasterKey 52- 40 
TEAaivate 49- 74 
TEBootlnit 49- 69 
TEClear 49- 75 
TEClick 49- 76 
TEColorTable, TextEdit data 

structure 49- 30 
TECompactRecord 49- 78 
TECopy 49- 79 
TECut 49- 80 
TEDeacUvate 49- 81 
TEFormat, TextEdit data structure 

49-34 
TEGetDefProc 49- 82 
TEGetlntemalProc 49- 83 
TEGetLastError 49- 84 
TEGetRuler 49- 85 
TEGetSeleaion 49- 87 
TEGetSelectionStyle 49- 88 
TEGetText 49- 91 
TEGetTextlnfo 49- 95 
TEIdle 49- 98 
TEInsert 49- 99 
TEKey 49- 102 
TEKiU 49- 103 
templates 
control 28-6 
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templates, Menu Manager 
menu bar template 37- 20 
menu item template 37- 15 
menu template 37- 18 

templates, Menu Manager 37- 15-20 

Tempo command, Note Sequencer 
40- 14 

TENew 49- 104 

TEOfFsetToPoint 49- 106 

TEPaintText 49- 108 

TEParamBlock 49- 3 

TEParamBlock, TextEdit data 
structure 49- 36 

TEParamBlock, TextEdit record 49- 
104 

TEPaste49- 110 

TEPointToOfFset 49- 111 

TERecord 

filterProcfield49-53 
handles to 49- 11 
keyFilterfield49-58 
textFlagsfield49-53 
theBufrerHPosfield49-58 
theBufferVPosfield49-58 
theFilterReaHeld49-58 
theKeyRecord field 49- 58 
wordBreakHook field 49- 57 
wordWrapHook field 49- 58 

TERecord 49- 3 

TERecord, TextEdit record layout 49- 
47 

TEReplace 49- 113 

TEReset 49- 72 

terminator character, in alert 

windows 52- 8 
TERuler, TextEdit record layout 49- 

44 

TESaoll 49- 116 
TESetRuler49- 118 
TESetSelection 49- 120 
TESetText 49- 121 
TEShutDown 49- 71 
TEStartUp 49- 70 
TEStatus 49- 73 

TEStyle, TextEdit record layout 49- 46 
TEStyleChange 49- 124 
TEUpdate 49- 127 
TEVersion 49- 72 
text justification in pictures 44- 2 
TextBlock, TextEdit record layout 49- 
67 

TextEdit 

activating records 49- 74 
and Control Manager 49- 14 



changing style information 49- 
124 

clearing selection 49- 75 
compressing records 49- 78 
copying text 49- 79 
aeating new records 49- 104 
current selection 49- 87, 88 
custom saoll bars 49- 28 
cutting text 49- 80 
data struaures 49- 29-68 
deactivating records 49- 81 
disposing of records 49- 103 
enor processing 49- 84 
features 49- 2 
filter procedures 49- 15-27 
generic filter procedure 
doEraseBuffer 49- 18 
doEraseRect 49- 17 

doReaChanged 49- 19 
generic filter procedure 49- 16 
hook routines 49- 15-27 
inserting text 49- 99 
justification 49- 3 
keyboard and mouse interface 

49-11 
KeyRecord 49- 59 
keystroke filter procedure 49- 20 
keystroke processing 49- 102 
pasting text 49-110 
printing with 49- 108 
replacing text 49- 113 
SCTollingtext 49- 116 
setting current selection 49- 120 
smart cut and paste 49- 3 
Styleltem49- 62 
SuperBlock 49- 63 
SuperHandle 49- 64 
Superltem 49- 65 
Tabltem 49- 66 
TEColorTable 49- 30 
TEFormat 49- 34 
TEParamBlock 49- 36 
TERecord 49- 47 
TERuler 49- 44 
TEStyle 49- 46 
TextBlock 49- 67 
TextList49-68 
tracking the mouse 49- 76 
word break hook routine 49- 26 
word wrap hook routine 49- 24 
TextEdit conuol 

control record 28- 131 
control template 28- 77 



TextEdit control 28- 6, 12 
TextEdit control template E- 38 
TextEdit records 49- 2 
textFlags, TEParamBlock record field 
49-41 

textFlags, TERecord field 49- 53 
Textlist, TextEdit record layout 49- 68 
theBufferHPos, TERecord field 49- 
18, 58 

theBufferVPos, TERecord field 49- 18, 
58 

theChar, TERecord KeyRecord field 

49- 20, 23 
theFilterRea, TERecord field 49- 17, 

18, 19, 58 
thelnputHandle, TERecord 

KeyRecord field 49- 20, 23 
theKeyRecord, TERecord field 49- 58 
theModifiers, TERecord KeyRecord 

field 49- 20, 23 
theOpCode, TERecord KeyRecord 

field 49- 22, 23 
time-stamps, reading MIDI data with 

38-16 

time-stamps, writing MIDI data with 
38- 18 

timing, in note sequences 40- 3 
title, menu, setting 37- 29 
tmContentControls taskMask flag 52- 
37 

tool set dependencies 51- 8 

tool set numbers 51- 6 

Turn Notes Off command, Note 

Sequencer 40- 15 
turning off notes in sequences 40- 48 
type 1 pop-up menus 37- 10 
type 2 pop-up menus 37- 10 

U 

UniqueResourcelD 45- 73 
UnPackBytes 39- 2 
UnPackBytes F- 13 
UpdateResourceFile 45- 75 
user ID, getting, for Resource 

Manager 45- 41 
user name, getting information 

about 42- 13 

V 

veaors, new system 39- 2 
version numbers, tool set 51- 2 
vertBar, TEParamBlock field 49- 28 
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Vibrato Depth command, Note 

Sequencer 40-15 
vibratoDepth, Note Synthesi2er 

parameter 41- 8, 13 
vibratoSpeed, Note Synthesizer 

parameter 41- 8 
voices, synthesizer 47- 9 
volume register 

Sound Tool Set and 47- 13 

W 

wave forms 

Sound Tool Set and 47- 11 
waveform data sample register 
Sound Tool Set and 47- 13 
waveform table register 

Sound Tool Set and 47- 13 
waveList, Note Synthesizer parameter 

41-9 
WindNewRes 52- 2 
WindNewRes F- 20 
window change, control definition 

procedure routine 28- 20 
window record, new definition 52- 
14 

window size, control definition 

procedure routine 28- 17 
word break, in TextEdit 49- 26 
word wrap, in TextEdit 49- 24 
wordBreakHook, TERecord field 49- 

26,57 

wordWrapHook, TERecord field 49- 

24,58 
WriteResource 45- 76 
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